Page MenuHomeFreeBSD
Differential D27318 Diff 109124 bin/freebsd-version/freebsd-version.1

Changeset View

Standalone View

View Options

bin/freebsd-version/freebsd-version.1

Context not available.
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
pauamma_gundo.comUnsubmitted
Done
Inline Actions

s/documented //

Also,

... in the
%B "Porter's Handbook" .

I'm not 100% sure about . after inline %B, so it may need adjusting.

pauamma_gundo.com: s/documented // Also, > ... in the > %B "Porter's Handbook" . I'm not 100% sure about .
.\" .\"
.Dd October 1, 2021 .Dd August 10, 2022
.Dt FREEBSD-VERSION 1 .Dt FREEBSD-VERSION 1
.Os .Os
.Sh NAME .Sh NAME
Context not available.
.Nd print the version and patch level of the installed system .Nd print the version and patch level of the installed system
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm .Nm
.Op Fl kru .Op Fl kruv
.Op Fl j Ar jail .Op Fl j Ar jail
.Sh DESCRIPTION .Sh DESCRIPTION
The The
pauamma_gundo.comUnsubmitted
Done
Inline Actions

Accidental text deletion between these lines? Sections SEE ALSO and HISTORY, and some of AUTHORS, all seem missing.

And I'd add the Porter's Handbook to SEE ALSO:

.Rs
.%B "Porter's Handbook"
.%Q "FreeBSD Documentation Project"
.%U https://docs.freebsd.org/en/books/fdp-primer/
.Re

pauamma_gundo.com: Accidental text deletion between these lines? Sections SEE ALSO and HISTORY, and some of…
Context not available.
These are hardcoded into These are hardcoded into
.Nm .Nm
during the build. during the build.
.It Fl v
grahamperrinUnsubmitted
Done
Inline Actions

This places option v alphabetically after u, followed by j.

I think, better to:

  1. preserve the sequence of k r u j – that is, strictly, the order of printing if two or more of these four options are specified ("… finally the userland version of the specified jails, …")
  2. then describe v (after j).
grahamperrin: This places option `v` alphabetically after `u`, followed by `j`. I think, better to: #…
egypcioAuthorUnsubmitted
Done
Inline Actions

IMHO, we already have a pretty solid order defined for this manpage (since its first implementation):

  1. options that do not take arguments (alph. sorted);
  2. options that take arguments (alph. sorted).

I do not see us all in a need to address this suggestion of yours into freebsd-version(1).

egypcio: IMHO, we already have a pretty solid order defined for this manpage (since its first…
Enable printing out verbose information for kernel and/or userland.
pauamma_gundo.comUnsubmitted
Done
Inline Actions

If it outputs values of __FreeBSD_version as it looks like to me, I'd mention that explicitely.

pauamma_gundo.com: If it outputs values of __FreeBSD_version as it looks like to me, I'd mention that explicitely.
grahamperrinUnsubmitted
Done
Inline Actions

More concisely:

Verbose output.

grahamperrin: More concisely: > Verbose output.
It's a representation of
.Pa "__FreeBSD_version" .
Those are also know as
.Pa OSRELDATE
or
.Pa OSVERSION .
More information about it is documented in the Porter's Handbook.
.It Fl j Ar jail .It Fl j Ar jail
Print the version and patch level of the installed userland in the Print the version and patch level of the installed userland in the
given jail specified by given jail specified by
grahamperrinUnsubmitted
Done
Inline Actions

… several of the above options is true for k r u j.

If option v is added above (not below) this paragraph, then this sentence might benefit from a rewrite.

grahamperrin: … //several of the above options// is true for `k` `r` `u` `j`. If option `v` is added above…
Context not available.
/bin/freebsd-version -u /bin/freebsd-version -u
.Ed .Ed
.Pp .Pp
To print out a more verbose output of the command above:
.Bd -literal -offset indent
/bin/freebsd-version -uv
.Ed
.Pp
To inspect a system being repaired using a live CD: To inspect a system being repaired using a live CD:
.Bd -literal -offset indent .Bd -literal -offset indent
mount -rt ufs /dev/ada0p2 /mnt mount -rt ufs /dev/ada0p2 /mnt
Context not available.
.Nm .Nm
utility and this manual page were written by utility and this manual page were written by
.An Dag-Erling Sm\(/orgrav Aq Mt des@FreeBSD.org . .An Dag-Erling Sm\(/orgrav Aq Mt des@FreeBSD.org .
The verbose information output was added and documented by
.An Vinicius Zavam Aq Mt egypcio@FreeBSD.org .
Context not available.