[SEMANAGE] Manpage reorganization

[SEMANAGE] Manpage reorganization

[Ivan Gyurdiev]

[-- Attachment #1: Type: text/plain, Size: 1129 bytes --]

Hi, this patch does the following:

Existing manpages:
===============
- remove listing of objects in each dbase function - this doesn't scale, 
I have to change it in 10+ places to add a new object, and it's really 
annoying. Just present the function template, and then we'll have 
per-object overview pages that link to that template, so the user won't 
be confused [ see new pages added below ].

- move the controlling page from *_user_local.3 to an object-neutral page:
semanage_add.3, semanage_modify.3, semanage_list.3 ... etc

- fix some allignment issues
- add "(3)" to references to other manpages so man2html makes links

New manpages:
============
- add an overview page for each object type, which gives all the 
functions for that object: semanage_fcontext.3 semanage_user.3, 
semanage_seuser.3, semanage_bool.3..etc. This page becomes more valuable 
when the functions listed there are also hyperlinks.

========
We should run man2html over all those pages, and host the result 
somewhere, once it's more complete.
Russell suggested James Morris' page (selinuxnews.org?)

I also plan to write a semanage.3 page.


[-- Attachment #2: libsemanage.doc.diff.bz2 --]
[-- Type: application/x-bzip, Size: 7461 bytes --]

Re: [SEMANAGE] Manpage reorganization

[James Morris]

On Thu, 16 Mar 2006, Ivan Gyurdiev wrote:

> We should run man2html over all those pages, and host the result somewhere,
> once it's more complete.
> Russell suggested James Morris' page (selinuxnews.org?)

That's possible, although the site is really intended just to carry 
pointers to other content.

There's also the Fedora SELinux wiki, and Tresys mentioned plans to set up 
a community web site, which would probably be the best option.



- James
-- 
James Morris
<jmorris@namei.org>

--
This message was distributed to subscribers of the selinux mailing list.
If you no longer wish to subscribe, send mail to majordomo@tycho.nsa.gov with
the words "unsubscribe selinux" without quotes as the message.