[tomoyo-dev-en 142] Re: Updated documentation

アーカイブの一覧に戻る

Jamie Nguyen dysco****@gmail*****
Wed Feb 9 07:45:10 JST 2011


So I am now very nearly finished with writing 1.8 documentation.
Hopefully in the next couple of days it will all be done. I need to
write chapter-12.html.en which will be on judging execute request
outside of the kernel and use of the execute handlers and
audit-exec-param. And chapter-3.html.en only has place holders and
must be replaced with real installation instructions. When all is done
I will do a final proof read for typos.

The docs related to
android/cat760/meego/sftp/ssh-protection/ssh-recording/ssh-split I
have merely restyled. I have no plans to change any of the core text.
I also worked through tool-editpolicy.html.en and made it shorter,
removing some pictures. Feel free to add back any pictures you want if
you think I have removed too much.


1) Could you please briefly check through the contents of
htdocs/1.8-tmp and let me know if there is any major changes you want
me to make, or whether there is something missing etc. ?


2) Also, I have implemented 1.8-tmp/tutorial-{15,16}.html.en in docs.
However, the "About keep_domain keyword" section of
tutorial-17.html.en seems to be a verbose explanation of how to limit
memory usage. I think I can insert a shorter version in
1.8-tmp/chapter-5.html.en#5.5 (or create chapter-5.html.en#5.6). The
"About execute handler mechanism" section of tutorial-17.html.en I
will place in chapter-12.html.en that I mentioned above. Thus, the
content that is left in tutorial-17 is the information about
difference between 1.7 and 1.8...I personally think this is more
relevant for release notes, but not in documentation so I will not
include. Do you have any objections?


3) Do you feel that we need to place verbose instructions in the
chapter-3.html.en about GRUB? I might just add a small note saying
something like "consult distro and bootloader docs for information".
Every distribution seems to use different method to update grub,
different default grub settings and different grub version etc. we
would have to have several distro specific instructions. Personally, I
think it is duplication of information as there are already several
places you can find out how to change grub entries and how to manage
grub. Also the user may be using syslinux or other bootloader. I'm
open to suggestion and don't really mind either way, but I think if
they have ventured out to use 1.8 instead of 2.3, they probably
already know how to use grub, and if they don't then it's easy enough
to find out how.


Kind regards




More information about the tomoyo-dev-en mailing list
アーカイブの一覧に戻る