> Hi Michael, > > Branden Robinson <[EMAIL PROTECTED]> submitted a patch he composed > with Colin Watson <[EMAIL PROTECTED]> and which I corrected to > mention the .URL macro more verbosely. What do you think about it?
Hi Joey, This looks useful. I've applied it as given. It will appear in man-pages 2.02. Cheers, Michael > Index: man.7 > =================================================================== > RCS file: /var/cvs/debian/manpages/man7/man.7,v > retrieving revision 1.17 > diff -u -p -r1.17 man.7 > --- man.7 2 Nov 2004 10:17:09 -0000 1.17 > +++ man.7 18 Dec 2004 10:58:20 -0000 > @@ -457,7 +457,9 @@ its results are like those of the > .B \&.IP > command. > .SS "Hypertext Link Macros" > -(Feature supported with groff only.) > +(Feature supported with > +.B groff > +only.) > In order to use hypertext link macros, it is necessary to load the > .B www.tmac > macro package. > @@ -483,6 +485,48 @@ This and other related macros are new, a > many tools won't do anything with them, but > since many tools (including troff) will simply ignore undefined macros > (or at worst insert their text) these are safe to insert. > +.\" The following is a kludge to get a paragraph into the listing. > +.TP > +.B " " > +It can be useful to define your own > +.B URL > +macro in manual pages for the benefit of those viewing it with a roff > +viewer other than > +.BR groff . > +That way, the URL, link text, and trailer text (if any) are still > visible. > +.\" The following is a kludge to get a paragraph into the listing. > +.TP > +.B " " > +Here's an example: > +.RS 1.5i > +\&.de URL > +.br > +\\\\$2 \\(laURL: \\\\$1 \\(ra\\\\$3 > +.br > +\&.. > +.br > +\&.if \\n[.g] .mso www.tmac > +.br > +\&.TH > +.I ... > +.br > +.I (later in the page) > +.br > +This software comes from the > +.br > +\&.URL "http://www.gnu.org/"; "GNU Project" " of the" > +.br > +\&.URL "http://www.fsf.org/"; "Free Software Foundation" . > +.RE > +.\" The following is a kludge to get a paragraph into the listing. > +.TP > +.B " " > +In the above, if > +.B groff > +is being used, the > +.B www.tmac > +macro package's definition of the URL macro will supersede the locally > +defined one. > .PP > A number of other link macros are available. See > .BR groff_www (7) > > > Regards, > > Joey > > -- > Experience is something you don't get until just after you need it. > > Please always Cc to me when replying to me on the lists. > -- Michael Kerrisk maintainer of Linux man pages Sections 2, 3, 4, 5, and 7 Please submit man page suggestions as "diff -u" patches if possible. Sign The Open Group "Developer Declaration of Independence" http://www.opengroup.org/declaration/ Sparen beginnt mit GMX DSL: http://www.gmx.net/de/go/dsl -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
