Am Mittwoch, den 19.04.2006, 10:28 +0900 schrieb Charles Plessy: > I have almost finished to package dialign (multiple sequence alignment), > and I have a little problem with the manpage. The xsl stylesheet adds an > extra AUTHOR section despite the AUTHORS section in my xml sources. > > Here is an html version : > http://charles.plessy.org/debian/dialign2-2.1.html > > The source: > http://charles.plessy.org/debian/dialign2-2.1.xml > > The conversion is done with the following command: > xsltproc -''-nonet > /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl > debian/dialign2-2.1.xml
Forget Debian's docbook-xsl package. It's hopelessly outdated Use the current docbook-xsl snapshots instead (the upcoming 1.70.0 version). I would further not use: <address>&dhemail;</address> <author> &dhfirstname; &dhsurname; </author> Instead use the sample you can find e.g. in the manpage sources at http://cvs.wgdd.de/cgi-bin/cvsweb/fglrx_man/. Any extra AUTHORS section in the XML source is not necessary. Also edition, date and productname (or refmiscinfo calss=software|version|source) are supported with the upcoming stylesheets. I suggest: Do not build the manpage during build-time. Build it earlier so you can drop any dependency to the outdated docbook-xsl package. The next problem is, the the catalog rewrites the 'current'-HTTP-source to the outdated Debian package. > I hope you can help me: I would like to use xml instead of sgml for > writing manpages in my packages (and scientific software very often lack > manpages). FACK. > (any general comment on the manpage is also welcome. It was generated by > cut-and-paste from the manual, hence the LGPL licence, which is the one > of the whole dialign sources). HTH. I can just recommend to use the current snapshots. Michael Smith did a real good job. My manpages (BTW: written for Debian too) are of course just samples. Regards, Daniel -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
