On Wed, 2006-11-22 at 14:39, Mike Noyes wrote:
> On Wed, 2006-11-22 at 09:10, Paul Traina wrote:
> > Mike Noyes wrote:
> > > On Mon, 2006-11-20 at 11:30, Mike Noyes wrote:
> > >> We have a location in cvs for man pages, and output them daily for our
> > >> documentation build. All someone needs to do is add them to our
> > >> repository.
> > >>
> > >> http://leaf.cvs.sourceforge.net/leaf/doc/man/ <-- man page source
> > >>
> > >> http://leaf-project.org/doc/man/ <-- generated pdf and html using groff
> > > 
> > > Everyone,
> > > We should probably update the BusyBox man page. Also, finding and adding
> > > the dash man page is probably a good idea.
> > > 
> > > Other man pages are welcome there. Just add them to our cvs repository
> > > and doc_build.sh will build them daily.
> > > 
> > 
> > This should be done automatically, not by hand.  Trying to maintain 
> > multiple copies of this stuff by hand has created most of the mess we 
> > see today.
> 
> Paul,
> Agreed. Is the Shorewall man page made available as html/pdf? I think we
> should link then.
> 
> doc-build.sh code used to convert man pages to html and pdf.
> 
>            89 build_man () {
>            90   cd "$TMP_DIR"/doc/man
>            91   for f in *; do
>            92     groff -t -mandoc -Thtml $f > $f.html
>            93     groff -t -mandoc -Tps $f > $f.ps
>            94     ps2pdf $f.ps
>            95     rm $f.ps
>            96   done
>            97 }

Paul,
I believe, an even better solution is using DocBook XInclude from LEAF
to the Shorewall site. This is only possible if you're using DocBook XML
<reference> to generate man pages, and the docbook xml source is
available via uri.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: leaf, phpwebsite, phpwebsite-comm, sitedocs


-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys - and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV

_______________________________________________
leaf-devel mailing list
leaf-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/leaf-devel

Reply via email to