Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 4 Jan 1999 14:21:24 -0500 (EST)
From:      Chuck Robey <chuckr@mat.net>
To:        Eivind Eklund <eivind@yes.no>
Cc:        Jun Kuriyama <kuriyama@sky.rim.or.jp>, committers <committers@FreeBSD.ORG>, man-jp-core@jp.freebsd.org
Subject:   Re: $Id$ tag in manpage
Message-ID:  <Pine.BSF.4.05.9901041414490.335-100000@picnic.mat.net>
In-Reply-To: <19990104181024.B2552@follo.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 4 Jan 1999, Eivind Eklund wrote:

> On Mon, Jan 04, 1999 at 11:36:53PM +0900, Jun Kuriyama wrote:
> > (as a member of Japanese Manual Translation Project)
> > 
> >   We are planning to start translation section 6 and 7 of manpages in
> > -current.  But we found that many manpages don't have $Id$ tags in their
> > sources.  If it is possible to add $Id$ tags into manpage sources in
> > freefall repository, it makes more easier our jobs for tracking latest
> > sources.
> >   Is there any special reason that many manpage sources do not include
> > $Id$ tags?  If not, I'll patch them like this.
> 
> There is a special reason: A lot of people has screwed up when
> committing manpages.
> 
> Just add the $Id$ tags - they are supposed to be there.

One point, I think another reason for the lack of man page $Id$ tags is
because they are *not* embedded in the familiar /* */ C style comments,
the troff comment introducer is .\" (at the start of a line, and the
rest of the line becomes a comment).  If everyone knew the comment
introducer, or it was readily at hand, I think there'd be more $Id$ tags
on man pages.

Just to make it clear, that was dot, backslash, doublequote.

BTW, this isn't like the # comment introducer for shell scripts, this
can't come in the middle of the line.


----------------------------+-----------------------------------------------
Chuck Robey                 | Interests include any kind of voice or data 
chuckr@glue.umd.edu         | communications topic, C programming, and Unix.
213 Lakeside Drive Apt T-1  |
Greenbelt, MD 20770         | I run Journey2 and picnic (FreeBSD-current)
(301) 220-2114              | and jaunt (NetBSD).
----------------------------+-----------------------------------------------





To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.4.05.9901041414490.335-100000>