Remove $FreeBSD$: one-line nroff pattern

Remove /^\.\\"\s*\$FreeBSD\$$\n/

Tell the world how to convert gigabytes to bytes with units(1) easily

It turns out that units(1) is not as horrible to use in scripts
as I initially thought. When the --terse flag is combined
with an appropriate output format (set via --output-format),
units(1) is actually capable of producing very nice results.
For example:

units -o %0.f -t '4 gigabytes' bytes

is is just going to print out the expected value of 4294967296.

There is no time to waste. People have to know about it.

I am adding an example for this at the top of the examples section
because this is what users are most likely looking for.

Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D24096

units(1): Refactor the manual page and update usage information

Changes to units.1:

- Change the description to a more descriptive "conversion calculator".
- Sort options.
- Split the description into sections to make it easier to navigate the
manual page.
- Improve the description of various options.
- Document the default value of the output format.
- Use more mdoc macros for better readability.
- Document the behavior of the PATH environmental variable.
- Improve examples.
- Add sections: EXIT STATUS, DIAGNOSTICS, and HISTORY.
- Document that units(1) cannot convert negative values and it handles long
unit lists poorly.
- Update the documentation of the -V flag to match the implementation.
units(1) prints its version and the units data file instead of its
version and usage information.

Changes to units.c:

- Update usage information.
- Sort longopts elements.

This commit does not attempts to change the current behavior of units(1).
What's left to do is probably defining a better versioning (at the moment
units(1) always reports "FreeBSD units" as its version) and changing the
behavior of the -V flag to only print version.

Reviewed by: allanjude (earlier version), bcr
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D18977

Correct a typo: was -> way.

Submitted by: Larry Hynes
MFC after: 3 days
Sponsored by: The FreeBSD Foundation

Correct the -H longopt equivillant

PR: 209876
Submitted by: <kdrakehp AT zoho DOT com>
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D11988

Escape No to avoid confusion with the No macro

Reported by: make manlint
MFC after: 2 days

Bring a little more compability with GNU units 2.12
- notionally support a 'history file' flag. This doesn't do much now,
but is there to prevent scripts written against GNU units from
breaking
- correctly gracefully quit rather than exit (this will make it easier
to support a history file in the future)
- remove the "t" flag from fopen which was there to support windows. We
have not supported windows since at the latest, the introduction of
capsicum.

Rename units.lib -> definitions.units
- this matches GNU units 2.12
add ISO country codes from units 2.12

units(1): Add support for output-format
Add support for the output-format argument. This also exposes subtle
rounding differences between GNU units and our units.

units: Support start of line comments with '#'
Modern GNU units(1) supports comments anywhere with '#' but take the easy route for now and at least support start of line # comments.

units(1): Add 'terse' support
terse output is used when calling units from another script.

units(1): Add 'help' flag
- Add support for --help for compatibility
- Make usage() static

units(1): Fix man page
Igor walks one way. I walked the other.

Reported by: wblock

units(1): add long options
Things brings additional compatibility with units 2.10

Discussed with: wblock (man page)

use .Mt to mark up email addresses consistently (part3)

PR: 191174
Submitted by: Franco Fichtner <franco at lastsummer.de>

units(1): Add v option: verbose

For increased compatibility with GNU units: support a -v option which
produces more verbose output when spitting out the answer.
GNU -v does additional work in the version, information, and check output which
we do not (yet?) replicate.

units(1): Add U option

For increased compatibility with GNU units: support a -U option which tests for the
existence of the default units file and prints it to the screen.

units(1): make -V print version instead of -v

The units program is likely little used. It is even less likely that a script
will want the units program to print out its version number by passing -v.

GNU units uses -V for version and -v for verbosity.

Increase compatibility between these two versions (written by the same author)
by switching our flag as well.

Take this opportunity to remove bogus information about the version number and
just call it 'FreeBSD units'.

Discussed with: cperciva, rwatson

mdoc: terminate quoted strings.

Reviewed by: brueffer

It seems when I added code for affine unit changes to units, I
forgot to tell the man page we could now convert Celsius to Fahrenheit.

Approved by: re (kib)
MFC after: 1 month

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.

- Import the HEAD csup code which is the basis for the cvsmode work.

Expand *n't contractions.

Sort sections.

Mechanically kill hard sentence breaks.

mdoc(7): Fixed list types.

Remove whitespace at EOL.

Reverse order of from and to in order to match reality.

PR: 26631
Submitted by: Glenn Johnson, glennpj@charter.net

All temperature scales are centigrades. Use "Celsius" instead.

As far as I can tell, you have never been able to use 'ab' as a unit
name if 'a' and 'b' are unit names. You can use 'a b' though.

Prepare for mdoc(7)NG.

mdoc(7) police: use certified section headers wherever possible.

$Id$ -> $FreeBSD$

.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.

Use err(3). Cosmetic in usage(). Rewrote man page in mdoc format.

Specify the full path of units.lib in the FILES section.

Revert $FreeBSD$ to $Id$

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Added revised manpage submitted by the author of units.

Reviewed by: alex
Submitted by: Adrian Mariano <adrian@cam.cornell.edu>

Units conversion utility courtesy of NetBSD.

Submitted by: Jeremy Prior
Obtained from: NetBSD