Page MenuHomeFreeBSD

release(7): Remove stray references to DOC* variables
ClosedPublic

Authored by debdrup on Feb 23 2021, 8:33 AM.

Details

Summary

We now live in the world of git, and release(7) should reflect that.

As of the commit referenced below, release images also no longer
include (stale) documentation, as the documentation has moved to
AsciiDoctor. This means that a few environment variables no longer
make sense, so remove them from their sections and mention them in
the compatibility section instead.

While here, also pet mandoc.

PR: 253615
MFC after: 3 days
MFC with: f61e92ca5a23 release: permanently remove the 'reldoc'
target and associates

Test Plan

Igor, mandoc, and mantra.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint OK
Unit
No Unit Test Coverage
Build Status
Buildable 37320
Build 34209: arc lint + arc unit

Event Timeline

lwhsu added inline comments.
share/man/man7/release.7
673

I suggest using the output of git rev-parse --short, which will detect how long the short hash is enough. So f61e92ca5a23.

yuripv added inline comments.
share/man/man7/release.7
681–682

bad sort order

debdrup marked 2 inline comments as done.

Address feedback by @lwhsu and @yuripv

Address feedback by @yuripv on IRC.

share/man/man7/release.7
673

The hash length is still 8, what src repo uses is 12.

This time actually correct the hash length, pointed out by @lwhsu

gjb added inline comments.
share/man/man7/release.7
616

This should reference '-b main', as the svn equivalent would checkout from head as written.

This revision is now accepted and ready to land.Feb 23 2021, 5:15 PM