Your message dated Mon, 4 Jan 2010 10:00:07 +0100 with message-id <[email protected]> has caused the report #462140, regarding maildrop: Man pages: code snippets don't appear to be marked as having been forwarded to the upstream software author(s) Sam Varshavchik <[email protected]>
(NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact [email protected] immediately.) -- 462140: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=462140 Debian Bug Tracking System Contact [email protected] with problems
--- Begin Message ---On Tue, 22 Jan 2008 19:50:10 +0100 Lionel Elie Mamane wrote: > The maildroprc(5) man page displays as: > > Command substitution > Text enclosed in back-tick characters is interpreted as a shell > command. The shell command is > executed as a child process by maildrop. Its output is used in place > of the command. For example: > places the names of the files in the current directory into the DIR > variable. > > but the source code of that part: > > .SS "Command substitution" > .PP > Text enclosed in back\-tick characters is interpreted as a shell command. The > shell command is executed as a child process by > \fBmaildrop\fR. Its output is used in place of the command. For example: > .sp .RS 4 .nf DIR=`ls` .fi .RE > places the names of the files in the current directory into the DIR variable. > .PP > > suggests it is meant to be displayed as something like > > Command substitution > Text enclosed in back-tick characters is interpreted as a shell > command. The shell command is > executed as a child process by maildrop. Its output is used in place > of the command. For example: > DIR=`ls` > places the names of the files in the current directory into the DIR > variable. > > Note the added actual example, "DIR=`ls`" On Mon, Jan 04, 2010 at 04:10:25AM +0100, Christoph Anton Mitterer wrote: > What's the status on this? Is it ever going to be fixed? > The same bug appears throughout all maildrop manpages and is really > annoying. Yes, the entire problem is likely caused by the tool that generates those manual pages in the upstream source. It's called docbook/sgml2man and it processes the maildrop.sgml file to generate maildropfilter.7.in, which in turn is used to generate maildropfilter(7) whose current version includes the line: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .if t \{\ .sp -1 .\} .BB lightgray adjust-for-leading-newline .sp -1 DIR=`ls` .EB lightgray adjust-for-leading-newline .if t \{\ .sp 1 .\} .fi .fam .ps +1 .if n \{\ .RE .\} And this simply doesn't render in normal man: % nroff -man maildropfilter.7.in | grep example: -A1 example: -- they use different quotes. For example: -- Its output is used in place of the command. For example: places the names of the files in the current directory into the DIR -- matched is placed in the MATCH variable. For example: matches a line of the form: -- started. For example: -- one section and matching it again. For example: -- entire file, lookup returns "0". For example: % However, those SGML and SGML-processing files aren't in the source package so I don't know exactly where to look... Sam? -- 2. That which causes joy or happiness.
--- End Message ---
