Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 07 Aug 2001 02:29:18 -0600
From:      Warner Losh <imp@harmony.village.org>
To:        Sheldon Hearn <sheldonh@starjuice.net>
Cc:        cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, doc@FreeBSD.org
Subject:   Re: Which OS does a man page come from? (was: cvs commit: src/bi 
Message-ID:  <200108070829.f778TI113023@harmony.village.org>
In-Reply-To: Your message of "Tue, 07 Aug 2001 10:20:42 %2B0200." <29772.997172442@axl.seasidesoftware.co.za> 
References:  <29772.997172442@axl.seasidesoftware.co.za>  

next in thread | previous in thread | raw e-mail | index | archive | help
In message <29772.997172442@axl.seasidesoftware.co.za> Sheldon Hearn writes:
: > : As I said: we add the .Os and .Dd when installing.
: > 
: > How is that different than just copying the mandoc macros that were
: > used to build the man pages from the {cd, network, wherever} you got
: > the man page sources from?
: 
: Um, Warner, the point is that right now, if Greg copies an installed
: _source_ manual page from a FreeBSD system, he gets an empty Os macro:
: 
: .Os
: 
: If we do as he suggests, he'll get a populated Os macro:
: 
: .Os FreeBSD 4.5

I understand that.  My point is why not pull the macros used to create
the man pages from the same place you pulled the man pages.  Eg, snag
/usr/share/tmac at the same time you snagged the man page and setenv
GROFF_TMAC_PATH to be where you stashed it.  I don't see how this is
different than grabbing old Makefiles and having them produce
different results on new machine or machines with different kinds of
make...

: > Adding the .Os and .Dd at install time seems ugly to me.
: 
: Why?  It's just a little Makefile magic.  We don't actually add the
: macro, just an argument, and only in the case where there are no
: arguments, e.g.
: 
: 	s/^\.Os$/.Os FreeBSD 4.5/g

Because it is another target?  You'd have foo.5 which would somehow
get generated from foo.5 which seems gross to me from a make point of
view.  I guess I don't see how that's transparently done in the build
process.

Warner

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?200108070829.f778TI113023>