Bug#383495: Please update manpage.xml.ex to better work with latest docbook-xsl
Am Donnerstag, den 26.04.2007, 12:49 +1000 schrieb Craig Small: On Tue, Apr 24, 2007 at 02:10:41PM +0200, Daniel Leidert wrote: What you did is exactly, what I told you not to do: - you removed the author tags instead of removing the self-written author-section (#376378) - you did not update this completely outdated manpage XML template (#383495) This is a little bit disappointing. Which reasons did you have? Those were changes I committed into svn a long time ago, so the reasons are long gone. The most likely reason is you or someone else DID say to do that, then changed your mind. So could you please update the template with the one I sent recently? If you find issues or have questions, please do not hesitate to ask me. But the current docbook-xsl versions really allow better semantics and better output, so we don't need this self-written author and/or copyright sections. Regards, Daniel -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#383495: Please update manpage.xml.ex to better work with latest docbook-xsl
OK, looking at the bug report, I used what was found in 376378 and not your bug report. Then they were merged so all seem right in the world. On Thu, Apr 26, 2007 at 12:41:15PM +0200, Daniel Leidert wrote: So could you please update the template with the one I sent recently? If I am looking at http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383495 You sent and email Dated Tue, 24 Apr 2007 17:29:03 +0200 (by the website) that has the patch manpage.xml.ex in it, is that the correct one? Want to make sure the right one goes in this time. - Craig -- Craig Small GnuPG:1C1B D893 1418 2AF4 45EE 95CB C76C E5AC 12CA DFA5 http://www.enc.com.au/ csmall at : enc.com.au http://www.debian.org/ Debian GNU/Linux, software should be Free -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#383495: Please update manpage.xml.ex to better work with latest docbook-xsl
Am Freitag, den 27.04.2007, 08:54 +1000 schrieb Craig Small: OK, looking at the bug report, I used what was found in 376378 and not your bug report. Then they were merged so all seem right in the world. On Thu, Apr 26, 2007 at 12:41:15PM +0200, Daniel Leidert wrote: So could you please update the template with the one I sent recently? If I am looking at http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383495 You sent and email Dated Tue, 24 Apr 2007 17:29:03 +0200 (by the Tue, 24 Apr 2007 17:29:04 +0200 - yes, that's the right one that shall have the fixed indentation too (as requested my Michael Biebl). website) that has the patch manpage.xml.ex in it, is that the correct one? Want to make sure the right one goes in this time. Thanks. Please don't hesitate to contact me, if you want to add some feature/content to this template or if you want to change some of the formatting output. I'm maintaining docbook2x, docbook-xsl and other relevant tools and would like to help to keep this template up-to-date. Regards, Daniel -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#383495: Please update manpage.xml.ex to better work with latest docbook-xsl
On Tue, Apr 24, 2007 at 02:10:41PM +0200, Daniel Leidert wrote: What you did is exactly, what I told you not to do: - you removed the author tags instead of removing the self-written author-section (#376378) - you did not update this completely outdated manpage XML template (#383495) This is a little bit disappointing. Which reasons did you have? Those were changes I committed into svn a long time ago, so the reasons are long gone. The most likely reason is you or someone else DID say to do that, then changed your mind. - Craig -- Craig Small GnuPG:1C1B D893 1418 2AF4 45EE 95CB C76C E5AC 12CA DFA5 http://www.enc.com.au/ csmall at : enc.com.au http://www.debian.org/ Debian GNU/Linux, software should be Free -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#383495: Please update manpage.xml.ex to better work with latest docbook-xsl
reopen 383495 thanks What you did is exactly, what I told you not to do: - you removed the author tags instead of removing the self-written author-section (#376378) - you did not update this completely outdated manpage XML template (#383495) This is a little bit disappointing. Which reasons did you have? Regards, Daniel -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#383495: Please update manpage.xml.ex to better work with latest docbook-xsl
Am Dienstag, den 22.08.2006, 00:03 +0200 schrieb Daniel Leidert:
[resulting manpage]
Seems I forgot it. Now it is attached too.
Argh. Now it is.
Regards, Daniel
.\ Title: FOO
.\Author: John Doe [EMAIL PROTECTED]
.\ Generator: DocBook XSL Stylesheets v1.70.1 http://docbook.sf.net/
.\ Date: 2006.08.17
.\Manual: foo User Manual
.\Source: foo
.\
.TH FOO 1 2006\-08\-17 foo foo User Manual
.\ disable hyphenation
.nh
.\ disable justification (adjust text to left margin only)
.ad l
.SH NAME
foo \- program to do something
.SH SYNOPSIS
.HP 4
\fBfoo\fR \fB\-e\ \fR\fB\fIthis\fR\fR [\fB\-\-example=\fR\fB\fIthat\fR\fR] [{\fB\-e\fR\ |\ \fB\-\-example\fR}\ \fIthis\fR] [{\fB\-e\fR\ |\ \fB\-\-example\fR}\ {\fIthis\fR\ |\ \fIthat\fR}]
.HP 4
\fBfoo\fR [{\fB\-h\fR\ |\ \fB\-\-help\fR} | {\fB\-v\fR\ |\ \fB\-\-version\fR}]
.SH DESCRIPTION
.PP
This manual page documents briefly the
\fBfoo\fR
and
\fBbar\fR
commands.
.PP
This manual page was written for the
Debian(TM)
distribution because the original program does not have a manual page. Instead, it has documentation in the
GNU
Info
format; see below.
.PP
\fBfoo\fR
is a program that...
.SH OPTIONS
.PP
The program follows the usual
GNU
command line syntax, with long options starting with two dashes (`\-'). A summary of options is included below. For a complete description, see the
Info
files.
.PP
\fB\-e \fR\fB\fIthis\fR\fR, \fB\-\-example=\fR\fB\fIthat\fR\fR
.RS 3n
Does this and that.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 3n
Show summary of options.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 3n
Show version of program.
.RE
.SH FILES
.TP 3n
\fI/etc/foo.conf\fR
The system\-wide configuration file to control the behaviour of
foo. See
\fBfoo.conf\fR(5)
for further details.
.TP 3n
\fI${HOME}/.foo.conf\fR
The per\-user configuration file to control the behaviour of
foo. See
\fBfoo.conf\fR(5)
for further details.
.SH ENVIONMENT
.TP 3n
\fBFOO_CONF\fR
If used, the defined file is used as configuration file (see also
the section called \(lqFILES\(rq).
.SH DIAGNOSTICS
.PP
The following diagnostics may be issued on
\fIstderr\fR:
.TP 3n
Bad configuration file. Exiting.
The configuration file seems to contain a broken configuration line. Use the
\fB\-\-verbose\fR
option, to get more info.
.PP
\fBfoo\fR
provides some return codes, that can be used in scripts:
.\ line length increase to cope w/ tbl weirdness
.ll +(\n(LLu * 62u / 100u)
.TS
ll.
\fICode\fR \fIDiagnostic\fR
T{
\fB0\fR
T} T{
Program exited successfully.
T}
T{
\fB1\fR
T} T{
The configuration file seems to be broken.
T}
.TE
.\ line length decrease back to previous value
.ll -(\n(LLu * 62u / 100u)
.sp
.SH BUGS
.PP
The program is currently limited to only work with the
foobar
library.
.PP
The upstreams
BTS
can be found at
\fI\%http://bugzilla.foo.tld\fR.
.SH SEE ALSO
.PP
\fBbar\fR(1),
\fBbaz\fR(1),
\fBfoo.conf\fR(5)
.PP
The programs are documented fully by
The Rise and Fall of a Fooish Bar
available via the
Info
system.
.SH AUTHOR
.PP
\fBJohn\fR \fBDoe\fR [EMAIL PROTECTED]
.sp -1n
.IP 3n
Manpage author.
.SH COPYRIGHT
Copyright \(co 2006 John Doe
.br
.PP
This manual page was written for the
Debian(TM)
system (but may be used by others).
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the
GNU
General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
\fIfile:///usr/share/common\-licenses/GPL\fR.
.br
Bug#383495: Please update manpage.xml.ex to better work with latest docbook-xsl
Package: debhelper Version: 5.0.37.3 Severity: wishlist Tags: patch -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hello, I would like to request an update of the manpage.xml.ex example, dh_make uses. After docbook-xsl 1.70.1 reached Debian Sid, the current example will clash with the stylesheets: - - the mail address should me moved into the author element and a contrib element should be added - - the self-written AUTHOR section should be removed - the latest docbook-xsl package automatically creates an AUTHOR section and it also adds a COPYRIGHT section, that contains the copyright (copyright element) and license information (legalnotice element). - - several options inside a variablelist, should be put in several term elements (this behaviour is now controlled via the variablelist.term.separator and variablelist.term.break.after parameters) and not in one term element by default - - the copyright year should be set to 2006 manually or replaced by dh_make too - - referencing manpages should be done using the citerefentry element IMHO the DocBook DTD can be raised to 4.4 too. I attached a sample manpage.xml.ex, which improves the content and adds some more sections samples, you can find in manpages (only sections also mentioned in the Linux Man Page Howto). Have a look at it and tell me your opinion. I've attached a sample manpage resulting from the example too. Regards, Daniel - -- System Information: Debian Release: testing/unstable APT prefers unstable APT policy: (850, 'unstable'), (700, 'testing'), (550, 'stable'), (110, 'experimental') Architecture: i386 (i686) Shell: /bin/sh linked to /bin/bash Kernel: Linux 2.6.15.08060320 Locale: LANG=de_DE, LC_CTYPE=de_DE (charmap=ISO-8859-1) Versions of packages debhelper depends on: ii binutils 2.17-2 The GNU assembler, linker and bina ii coreutils 5.97-3 The GNU core utilities ii dpkg-dev 1.13.22package building tools for Debian ii file 4.17-3 Determines file type using magic ii html2text 1.3.2a-3 An advanced HTML to text converter ii perl 5.8.8-6.1 Larry Wall's Practical Extraction ii po-debconf1.0.5 manage translated Debconf template debhelper recommends no packages. - -- no debconf information -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.5 (GNU/Linux) iD8DBQFE5Jstdg0kG0+YFBERAq0NAJwL3COanBgfPjMd8Lo8Octaf1ZRVACbBw6J 4rBswIqXELRggVfBxy3ymRI= =BcCY -END PGP SIGNATURE- manpage.xml.ex Description: Binary data
