Re: 'woman' can't format the ssh man page
That man page is written in doc rather than in an. With modern groff you have to pass -man-old to get the old an macros w/o also supporting the newer doc macros. If you do that with ssh.1 you see the same results as woman shows. This means that what woman needs is support for the doc macro set. (Sometimes AKA the mdoc macro set.) -JimC -- James Cloos <[EMAIL PROTECTED]> OpenPGP: 1024D/ED7DAEA6 ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
Chris Moore wrote: > I don't know if this has been reported before - it's a bug that I've > become so used to that I almost don't notice myself working around it > any more... Ditto. I reported the issue with the very same manpage in May 2004: http://lists.gnu.org/archive/html/emacs-pretest-bug/2004-05/msg00144.html The consensus then (off list, with the woman author) was that it would be nice if woman could at least say "don't know how to format man pages of type FOO" and produce no output, rather than displaying a broken page. And also it could "suggest writing to the maintainer of the man pages in question to suggest using the standard macros"... ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
That man page is written in doc rather than in an. Can we make woman detect use of the doc macros and give a meaningful error message? ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
> "RMS" == Richard Stallman <[EMAIL PROTECTED]> writes: RMS> Can we make woman detect use of the doc macros RMS> and give a meaningful error message? Grog(1) (part of groff) uses this logic to guess -man macros: if: any line matches /^\.SH[\s\n]/ and if any (other) line matches /^\.TH[\s\n]/ and if no line matches /^\.([pnil]p|sh)[\s\n]/ then: it uses an It should be enough for woman to check for those (perl-style) regexps. At least for now. For doc, if it is not an, e, om, s or m, and if any line matches /^\.Dd/, then it is either doc or doc-old. For after the 22 release, it would seem a good idea to convert the full grog logic to elisp; I'm sure it would be useful to more than just woman. -JimC -- James Cloos <[EMAIL PROTECTED]> OpenPGP: 1024D/ED7DAEA6 ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
Richard Stallman <[EMAIL PROTECTED]> writes: > That man page is written in doc rather than in an. > > Can we make woman detect use of the doc macros > and give a meaningful error message? I checked in the test suggested by James Cloos. ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
> Can we make woman detect use of the doc macros > and give a meaningful error message? I checked in the test suggested by James Cloos. Thank you. ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
Chong Yidong <[EMAIL PROTECTED]> writes: > Richard Stallman <[EMAIL PROTECTED]> writes: > >> That man page is written in doc rather than in an. >> >> Can we make woman detect use of the doc macros >> and give a meaningful error message? > > I checked in the test suggested by James Cloos. So now it says: "woman-decode-buffer: WoMan can only format manpages written in the an format" Wouldn't that be clearer if the 'an' was in quotes, what with 'an' being a word in the English language and all, and not a format many Emacs will have heard of I guess. I had to read the sentence a few times to parse it correctly. ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
Chris Moore <[EMAIL PROTECTED]> writes: > So now it says: > > "woman-decode-buffer: WoMan can only format >manpages written in the an format" > > Wouldn't that be clearer if the 'an' was in quotes, what with 'an' > being a word in the English language and all, and not a format many > Emacs will have heard of I guess. I had to read the sentence a few > times to parse it correctly. IMO, even better would be '-man' as that is what's passed to nroff to format a normal man page. -- Kim F. Storm <[EMAIL PROTECTED]> http://www.cua.dk ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
[EMAIL PROTECTED] (Kim F. Storm) writes: > IMO, even better would be '-man' as that is what's passed to nroff > to format a normal man page. Well, '-m' is the flag and 'an' in the name of the macro package it's using, so 'an' isn't incorrect here, it's just not very clear. ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
Re: 'woman' can't format the ssh man page
I will improve that error message. Thanks. ___ emacs-pretest-bug mailing list emacs-pretest-bug@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug