Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 8 Jan 2021 18:32:51 +0000
From:      Alexander Best <arundel@freebsd.org>
To:        Polytropon <freebsd@edvax.de>
Cc:        freebsd-questions@freebsd.org
Subject:   Re: Possibly malformed date in several manual pages
Message-ID:  <20210108183251.GA71246@freebsd.org>
In-Reply-To: <20210108131811.357f173c.freebsd@edvax.de>
References:  <20210107080827.GA10295@freebsd.org> <20210108113505.GA41405@freebsd.org> <20210108131811.357f173c.freebsd@edvax.de>

next in thread | previous in thread | raw e-mail | index | archive | help

--SUOF0GtieIMvvwua
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Fr. Jan.  8 2021, Polytropon wrote:
> On Fri, 8 Jan 2021 11:35:05 +0000, Alexander Best wrote:
> > "$Date:" and "$" in the vacation-example of course aren't pretty to hav=
e in a
> > manual page, but I crosschecked with Linux and here those terms are also
> > displayed at the end of the according manual page.
> >=20
> > One might could take care of this during the installation process of th=
e manual
> > pages, but it's probably not worth the hassle.
>=20
> Just a question:
>=20
> It looks like "$Date: <something> $" is expanded from the $Date$
> header known in CVS (among others). With the transition to SVN
> and now to Git, wouldn't those be subject to being converted into
> Git's own human-readable headers, making the date information
> known to the version control system, or maybe "overwriting" them
> with its own timestamp? Or are they kept "as is" when importing
> sources from other version control systems (like RCS, CVS, SVN)?

Hi Polytropon,

that's a valid question. I'm not sure, to be honest. Looking at older *.c f=
iles
withing the FreeBSD repository which originated from 4.*BSD or UNIX shows s=
ome
legacy vcs-tags. These however mostly appear in the initial copyright state=
ment
and thus don't affect the code (or the manuals).

[1] on the other hands states the following:

"The dist tree can be cleaned up as necessary. Disabling keyword expansion =
is
recommended, as it makes no sense on unmodified vendor code and in some cas=
es
it can even be harmful. OpenSSH, for example, includes two files that origi=
nated
with FreeBSD and still contain the original version tags."

One could of course get a snapshot (e.g. via svn) of some vendor import and=
 try
to remove the tags using `svn propdel svn:keywords -R .`?

I wouldn't vote for removing legacy tags in general, but would like to see
sensable TH-statements within those manual pages I mentioned.

Kind regards,
Alexander

1: https://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-guide/ar=
ticle.html#subversion-primer,
   Section 5.4.4.1.2. (Cleaning Up).

>=20
>=20
>=20
> --=20
> Polytropon
> Magdeburg, Germany
> Happy FreeBSD user since 4.0
> Andra moi ennepe, Mousa, ...

--SUOF0GtieIMvvwua
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQJ8BAEBCgBmBQJf+KVRXxSAAAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25zLm9w
ZW5wZ3AuZmlmdGhob3JzZW1hbi5uZXQ0NEFCRkJFNkIyOTQ5NkYzQzFFQTc5NDE3
RjQzRThCNkQ4OTM3NDUwAAoJEH9D6LbYk3RQQYwQAJKeZQqSf5rILIqSg+Uf+1oX
T5BIa2jl3uhjeqoT72Jv5IY91XOA7/c7bNoktwUOHlQhOQojTaZqtUE97d6makP9
MODgw8KU2exHqGFgGwPPOupgtOOnE7Zbvno6Qw/WMf+6TwD9YVgZ6IN2kQIpfSJ7
Yg9Asxvls+pJQFHjjaxM0J+rGD9Qtc6f3IU6y1gZ0Y4qcCbQCGcsgRqQyijn7TFc
oavcckld509NbwCQG6YHjzsK4tBtczwETpamtfdlntKAY/cuZqmcOYrNZRYOgqdj
Lu8GT8RyX+bkIav+7SAV2ReBC4oyCCSewgwAgZ4m5WdZBl4Fs1+ZU2YLbytlvkgT
xE2yDoljBykJO0FG5KdH8D6RHlyUcsMfg479MjnDE83NM+t7hdDIX/s37o+e7PsW
0ZZc5A1rNdjRE5HimOQBEHAlGUpBiAZ5lX//7Tz2G/NnoSADvIIrqquAYeM7Ygc8
kmMxJy5ERThBmGRZXDNG9WYKYh7TDfwcINu4jAgZ5Nv1jGr7xwRO2kPfYCtmYehC
kdERxX2O3FEypZv+ziKD9aeoI2SOwXBTeBF4AtBcFR9MK7jjZjykLYyP49plbPY2
rMCaoqSRHxKlgLK2aglMK5zJf+hRBbLzgCciG54qpEclSt8ngqdHjE+t5+ltXgJf
s+ai0cTBx8PNOsM+YyeS
=hYSq
-----END PGP SIGNATURE-----

--SUOF0GtieIMvvwua--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210108183251.GA71246>