MFC r309796:

Perl is not available in base fix scripts depending on it to use
the version from ports

PR: 215159
Reported by: Anatoly Kamchatnov <akamch@gmail.com>

Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Add SUSv4 reference macro to our groff mdoc. mdocml already supports it.

Sponsored by: The FreeBSD Foundation

Improve collation string and locales support

Merge collation support from Illumos and DragonflyBSD.

Locales are now generated with the new localedef(1) tool from CLDR POSIX files.
The generated files are now identified as "BSD 1.0" format.

The libc now only read "BSD 1.0" locales definitions, all other version will be
set to "C"
The localedef(1) tool has been imported from Illumos and modified to use tree(3)
instead of the CDDL avl(3)
A set of tool created by edwin@ and extended by marino@ for dragonfly has been
added to be able to generate locales and the Makefiles from the vanilla CLDR
unicode databases + a universal UTF-8 charmap (by marino@)
Update the locales to unicode v27
Given our regex(3) does not support multibyte (yet) it has been forced to always
use locale C
Remove now unused colldef(1) and mklocale(1)
Finish implementing the numeric BSD extension for ctypes
The number of supported locales has grown from 175 to 250 locales. Among the new
locales: 6 Arabic locales (AE EG JO MA QA SA), Different variations of spanish
locales.
Added new 3 components locales for mn_Cyrl_MN, sr_Cyrl_RS sr_Latn_RS,
zh_Hans_CN, zh_Hant_HK and zh_Hant_TW. Some aliases has been for 2 components
version when possible.

Thanks: Garrett D'Amore (Illumos) who made sure all his work was done under
BSD license!, Edwin Groothuis (edwin@) for the work he made on tools to be able
to generate locales definition usable in freebsd sources out of vanilla CLDR
definitions, John Marino (DragonflyBSD) who first merge the Illumos work into
Dragonfly and spent hours tracking down bugs.

Merge mpsutil(8) branch

mpsutil(8)/mprutil(8) are new utilities for managing LSI Fusion-MPT
2/3 controllers (mps(4) and mpr(4))

For now only informational commands have been implemented.

This utility has been written by scottl@ [1] and polished by myself[2]

Submitted by: scottl
Discussed with: scottl
Relnotes: yes
Sponsored by: Netflix [1]
Sponsored by: Gandi.net [2]

Remove more disconnected libgpib items missed in r276214.

Sponsored by: EMC / Isilon Storage Division

Upgrade our copy of clang, llvm and lldb to 3.6.0 release.

Please note that from 3.5.0 onwards, clang/llvm/lldb require C++11
support to build; see UPDATING for more information.

Release notes for llvm and clang can be found here:
<http://llvm.org/releases/3.6.0/docs/ReleaseNotes.html>
<http://llvm.org/releases/3.6.0/tools/clang/docs/ReleaseNotes.html>

Thanks to Ed Maste for the lldb part of this upgrade.

Exp-run: antoine

Significant upgrades to sa(4) and mt(1).

The primary focus of these changes is to modernize FreeBSD's
tape infrastructure so that we can take advantage of some of the
features of modern tape drives and allow support for LTFS.

Significant changes and new features include:

o sa(4) driver status and parameter information is now exported via an
XML structure. This will allow for changes and improvements later
on that will not break userland applications. The old MTIOCGET
status ioctl remains, so applications using the existing interface
will not break.

o 'mt status' now reports drive-reported tape position information
as well as the previously available calculated tape position
information. These numbers will be different at times, because
the drive-reported block numbers are relative to BOP (Beginning
of Partition), but the block numbers calculated previously via
sa(4) (and still provided) are relative to the last filemark.
Both numbers are now provided. 'mt status' now also shows the
drive INQUIRY information, serial number and any position flags
(BOP, EOT, etc.) provided with the tape position information.
'mt status -v' adds information on the maximum possible I/O size,
and the underlying values used to calculate it.

o The extra sa(4) /dev entries (/dev/saN.[0-3]) have been removed.

The extra devices were originally added as place holders for
density-specific device nodes. Some OSes (NetBSD, NetApp's OnTap
and Solaris) have had device nodes that, when you write to them,
will automatically select a given density for particular tape drives.

This is a convenient way of switching densities, but it was never
implemented in FreeBSD. Only the device nodes were there, and that
sometimes confused users.

For modern tape devices, the density is generally not selectable
(e.g. with LTO) or defaults to the highest availble density when
the tape is rewritten from BOT (e.g. TS11X0). So, for most users,
density selection won't be necessary. If they do need to select
the density, it is easy enough to use 'mt density' to change it.

o Protection information is now supported. This is either a
Reed-Solomon CRC or CRC32 that is included at the end of each block
read and written. On write, the tape drive verifies the CRC, and
on read, the tape drive provides a CRC for the userland application
to verify.

o New, extensible tape driver parameter get/set interface.

o Density reporting information. For drives that support it,
'mt getdensity' will show detailed information on what formats the
tape drive supports, and what formats the tape drive supports.

o Some mt(1) functionality moved into a new mt(3) library so that
external applications can reuse the code.

o The new mt(3) library includes helper routines to aid in parsing
the XML output of the sa(4) driver, and build a tree of driver
metadata.

o Support for the MTLOAD (load a tape in the drive) and MTWEOFI
(write filemark immediate) ioctls needed by IBM's LTFS
implementation.

o Improve device departure behavior for the sa(4) driver. The previous
implementation led to hangs when the device was open.

o This has been tested on the following types of drives:
IBM TS1150
IBM TS1140
IBM LTO-6
IBM LTO-5
HP LTO-2
Seagate DDS-4
Quantum DLT-4000
Exabyte 8505
Sony DDS-2

contrib/groff/tmac/doc-syms,
share/mk/bsd.libnames.mk,
lib/Makefile,
Add libmt.

lib/libmt/Makefile,
lib/libmt/mt.3,
lib/libmt/mtlib.c,
lib/libmt/mtlib.h,
New mt(3) library that contains functions moved from mt(1) and
new functions needed to interact with the updated sa(4) driver.

This includes XML parser helper functions that application writers
can use when writing code to query tape parameters.

rescue/rescue/Makefile:
Add -lmt to CRUNCH_LIBS.

src/share/man/man4/mtio.4
Clarify this man page a bit, and since it contains what is
essentially the mtio.h header file, add new ioctls and structure
definitions from mtio.h.

src/share/man/man4/sa.4
Update BUGS and maintainer section.

sys/cam/scsi/scsi_all.c,
sys/cam/scsi/scsi_all.h:
Add SCSI SECURITY PROTOCOL IN/OUT CDB definitions and CDB building
functions.

sys/cam/scsi/scsi_sa.c
sys/cam/scsi/scsi_sa.h
Many tape driver changes, largely outlined above.

Increase the sa(4) driver read/write timeout from 4 to 32
minutes. This is based on the recommended values for IBM LTO
5/6 drives. This may also avoid timeouts for other tape
hardware that can take a long time to do retries and error
recovery. Longer term, a better way to handle this is to ask
the drive for recommended timeout values using the REPORT
SUPPORTED OPCODES command. Modern IBM and Oracle tape drives
at least support that command, and it would allow for more
accurate timeout values.

Add XML status generation. This is done with a series of
macros to eliminate as much duplicate code as possible. The
new XML-based status values are reported through the new
MTIOCEXTGET ioctl.

Add XML driver parameter reporting, using the new MTIOCPARAMGET
ioctl.

Add a new driver parameter setting interface, using the new
MTIOCPARAMSET and MTIOCSETLIST ioctls.

Add a new MTIOCRBLIM ioctl to get block limits information.

Add CCB/CDB building routines scsi_locate_16, scsi_locate_10,
and scsi_read_position_10().

scsi_locate_10 implements the LOCATE command, as does the
existing scsi_set_position() command. It just supports
additional arguments and features. If/when we figure out a
good way to provide backward compatibility for older
applications using the old function API, we can just revamp
scsi_set_position(). The same goes for
scsi_read_position_10() and the existing scsi_read_position()
function.

Revamp sasetpos() to take the new mtlocate structure as an
argument. It now will use either scsi_locate_10() or
scsi_locate_16(), depending upon the arguments the user
supplies. As before, once we change position we don't have a
clear idea of what the current logical position of the tape
drive is.

For tape drives that support long form position data, we
read the current position and store that for later reporting
after changing the position. This should help applications
like Bacula speed tape access under FreeBSD once they are
modified to support the new ioctls.

Add a new quirk, SA_QUIRK_NO_LONG_POS, that is set for all
drives that report SCSI-2 or older, as well as drives that
report an Illegal Request type error for READ POSITION with
the long format. So we should automatically detect drives
that don't support the long form and stop asking for it after
an initial try.

Add a partition number to the sa(4) softc.

Improve device departure handling. The previous implementation
led to hangs when the device was open.

If an application had the sa(4) driver open, and attempted to
close it after it went away, the cam_periph_release() call in
saclose() would cause the periph to get destroyed because that
was the last reference to it. Because destroy_dev() was
called from the sa(4) driver's cleanup routine (sacleanup()),
and would block waiting for the close to happen, a deadlock
would result.

So instead of calling destroy_dev() from the cleanup routine,
call destroy_dev_sched_cb() from saoninvalidate() and wait for
the callback.

Acquire a reference for devfs in saregister(), and release it
in the new sadevgonecb() routine when all devfs devices for
the particular sa(4) driver instance are gone.

Add a new function, sasetupdev(), to centralize setting
per-instance devfs device parameters instead of repeating the
code in saregister().

Add an open count to the softc, so we know how many
peripheral driver references are a result of open
sessions.

Add the D_TRACKCLOSE flag to the cdevsw flags so
that we get a 1:1 mapping of open to close calls
instead of a N:1 mapping.

This should be a no-op for everything except the
control device, since we don't allow more than one
open on non-control devices.

However, since we do allow multiple opens on the
control device, the combination of the open count
and the D_TRACKCLOSE flag should result in an
accurate peripheral driver reference count, and an
accurate open count.

The accurate open count allows us to release all
peripheral driver references that are the result
of open contexts once we get the callback from devfs.

sys/sys/mtio.h:
Add a number of new mt(4) ioctls and the requisite data
structures. None of the existing interfaces been removed
or changed.

This includes definitions for the following new ioctls:

MTIOCRBLIM /* get block limits */
MTIOCEXTLOCATE /* seek to position */
MTIOCEXTGET /* get tape status */
MTIOCPARAMGET /* get tape params */
MTIOCPARAMSET /* set tape params */
MTIOCSETLIST /* set N params */

usr.bin/mt/Makefile:
mt(1) now depends on libmt, libsbuf and libbsdxml.

usr.bin/mt/mt.1:
Document new mt(1) features and subcommands.

usr.bin/mt/mt.c:
Implement support for mt(1) subcommands that need to
use getopt(3) for their arguments.

Implement a new 'mt status' command to replace the old
'mt status' command. The old status command has been
renamed 'ostatus'.

The new status function uses the MTIOCEXTGET ioctl, and
therefore parses the XML data to determine drive status.
The -x argument to 'mt status' allows the user to dump out
the raw XML reported by the kernel.

The new status display is mostly the same as the old status
display, except that it doesn't print the redundant density
mode information, and it does print the current partition
number and position flags.

Add a new command, 'mt locate', that will supersede the
old 'mt setspos' and 'mt sethpos' commands. 'mt locate'
implements all of the functionality of the MTIOCEXTLOCATE
ioctl, and allows the user to change the logical position
of the tape drive in a number of ways. (Partition,
block number, file number, set mark number, end of data.)
The immediate bit and the explicit address bits are
implemented, but not documented in the man page.

Add a new 'mt weofi' command to use the new MTWEOFI ioctl.
This allows the user to ask the drive to write a filemark
without waiting around for the operation to complete.

Add a new 'mt getdensity' command that gets the XML-based
tape drive density report from the sa(4) driver and displays
it. This uses the SCSI REPORT DENSITY SUPPORT command
to get comprehensive information from the tape drive about
what formats it is able to read and write.

Add a new 'mt protect' command that allows getting and setting
tape drive protection information. The protection information
is a CRC tacked on to the end of every read/write from and to
the tape drive.

Sponsored by: Spectra Logic
MFC after: 1 month

Upgrade our copy of clang, llvm and lldb to 3.5.0 release.

Please note that this version now requires C++11 support to build; see
UPDATING for more information.

Release notes for llvm and clang can be found here:
<http://llvm.org/releases/3.5.0/docs/ReleaseNotes.html>
<http://llvm.org/releases/3.5.0/tools/clang/docs/ReleaseNotes.html>

Thanks to Ed Maste, Roman Divacky, Andrew Turner, Justin Hibbits and
Antoine Brodin for their invaluable help with this import.

Approved by: portmgr (antoine)
MFC after: 1 month

Pull up vendor changes up to 2014-01-29

- move local overrides into mdoc.local
- syncs us with git commit 819839b66c80e8dabe6cb24ea6319c26c9a2be14

Discussed with: ru
MFC after: 2 weeks

Quiesce warnings -Wdangling-else

Thanks to jilles for some reviews and tips.

Add libsbuf.

Pull up vendor changes to mdoc(7).

Backed out r228904, and added libstdthreads support to mdoc(7) to where
it belongs.

Backed out r236255, and added FreeBSD 9.1 support to mdoc(7) to where
it belongs.

Add the latest FreeBSD versions.

Pull up vendor changes to mdoc(7)

This switches us to using -isoC-2011 as the symbol name which is used by
groff and mdocml. It follows the change to 4 digit years as done with
IEEE Std 1003 post-1999.

MFC after: 2 weeks (groff changes only)

Add libstdthreads.

This library implements the C11 threads interface on top of the pthreads
library. As discussed on the lists, the preferred way to implement
this, is as a separate library.

It is unlikely that these functions will be used a lot in the future. It
would have been easier if the C11 working group standardized (a subset
of) pthreads and clock_nanosleep(). Having it as a separate library
allows the embedded people to omit it from their system.

Discussed on: arch@, threads@

Add the C11 standard to groff. This allows us to refer to C11 as -isoC-11.

MFC after: 2 months

Pull up vendor changes to mdoc(7).

With retirement of cpumask_t and usage of cpuset_t for representing a
mask of CPUs, pc_other_cpus and pc_cpumask become highly inefficient.

Remove them and replace their usage with custom pc_cpuid magic (as,
atm, pc_cpumask can be easilly represented by (1 << pc_cpuid) and
pc_other_cpus by (all_cpus & ~(1 << pc_cpuid))).

This change is not targeted for MFC because of struct pcpu members
removal and dependency by cpumask_t retirement.

MD review by: marcel, marius, alc
Tested by: pluknet
MD testing by: marcel, marius, gonzo, andreast

Pull up all vendor changes to mdoc(7).

This also replaces the local fix in r219209 that made .Ac emit
ASCII angle quotes with an official fix. In the official fix,
ASCII quotes are output when using the .Aq, .Ao and .Ac calls,
but only when nested into the .An macro.

PR: gnu/154822

etire the cpumask_t type and replace it with cpuset_t usage.

This is intended to fix the bug where cpu mask objects are
capped to 32. MAXCPU, then, can now arbitrarely bumped to whatever
value. Anyway, as long as several structures in the kernel are
statically allocated and sized as MAXCPU, it is suggested to keep it
as low as possible for the time being.

Technical notes on this commit itself:
- More functions to handle with cpuset_t objects are introduced.
The most notable are cpusetobj_ffs() (which calculates a ffs(3)
for a cpuset_t object), cpusetobj_strprint() (which prepares a string
representing a cpuset_t object) and cpusetobj_strscan() (which
creates a valid cpuset_t starting from a string representation).
- pc_cpumask and pc_other_cpus are target to be removed soon.
With the moving from cpumask_t to cpuset_t they are now inefficient
and not really useful. Anyway, for the time being, please note that
access to pcpu datas is protected by sched_pin() in order to avoid
migrating the CPU while reading more than one (possible) word
- Please note that size of cpuset_t objects may differ between kernel
and userland. While this is not directly related to the patch itself,
it is good to understand that concept and possibly use the patch
as a reference on how to deal with cpuset_t objects in userland, when
accessing kernland members.
- KTR_CPUMASK is changed and now is represented through a string, to be
set as the example reported in NOTES.

Please additively note that no MAXCPU is bumped in this patch, but
private testing has been done until to MAXCPU=128 on a real 8x8x2(htt)
machine (amd64).

Please note that the FreeBSD version is not yet bumped because of
the upcoming pcpu changes. However, note that this patch is not
targeted for MFC.

People to thank for the time spent on this patch:
- sbruno, pluknet and Nicholas Esborn (nick AT desert DOT net) tested
several revision of the patches and really helped in improving
stability of this work.
- marius fixed several bugs in the sparc64 implementation and reviewed
patches related to ktr.
- jeff and jhb discussed the basic approach followed.
- kib and marcel made targeted review on some specific part of the
patch.
- marius, art, nwhitehorn and andreast reviewed MD specific part of
the patch.
- marius, andreast, gonzo, nwhitehorn and jceel tested MD specific
implementations of the patch.
- Other people have made contributions on other patches that have been
already committed and have been listed separately.

Companies that should be mentioned for having participated at several
degrees:
- Yahoo! for having offered the machines used for testing on big
count of CPUs.
- The FreeBSD Foundation for having sponsored my devsummit attendance,
which has been instrumental.
- Sandvine for having offered offices and infrastructure during
development.

(I really hope I didn't forget anyone, if it happened I apologize in
advance).

Re-enable SGR support (ANSI color escapes) in grotty(1) by default.
Our man(1) and bsd.doc.mk still disable it for POLA reasons via the
-c option to grotty(1).

PR: gnu/82353

Fix clang warnings.

Note: possible minor security issues fixed (untrusted string used as
printf format string).

Approved by: philip (mentor)

Unbreak .Aq for non-ASCII output like -Tps or -Tutf8.

groff will try to produce fancy angle brackets like
Foo ⟨foo@FreeBSD.org⟩
This is nice and well, but no email client will understand them. For
ease of copy&paste keep the one-true pair of brackets 0x3c/0x3e.

See: RFC 822, RFC 2822
PR: gnu/154822
Submitted by: Dominic Fandrey <kamikaze@bsdforen.de>
MFC after: 2 weeks

Update groff manpage and symbols with what has been submitted upstream.
Also remove local overrides that are now in the contrib tree.

This is a direct commit to contrib/ as we will no longer import any
newer groff snapshots, due to licensing issues.

MFC after: 3 weeks

Merger of the quota64 project into head.

This joint work of Dag-Erling Smørgrav and myself updates the
FFS quota system to support both traditional 32-bit and new 64-bit
quotas (for those of you who want to put 2+Tb quotas on your users).

By default quotas are not compiled into the kernel. To include them
in your kernel configuration you need to specify:

options QUOTA # Enable FFS quotas

If you are already running with the current 32-bit quotas, they
should continue to work just as they have in the past. If you
wish to convert to using 64-bit quotas, use `quotacheck -c 64';
if you wish to revert from 64-bit quotas back to 32-bit quotas,
use `quotacheck -c 32'.

There is a new library of functions to simplify the use of the
quota system, do `man quotafile' for details. If your application
is currently using the quotactl(2), it is highly recommended that
you convert your application to use the quotafile interface.
Note that existing binaries will continue to work.

Special thanks to John Kozubik of rsync.net for getting me
interested in pursuing 64-bit quota support and for funding
part of my development time on this project.

Pull up vendor changes.

Moved the doc-str-Lb-libulog string definition to where it belongs.

Pull up vendor changes. The following local changes made obsolete:

- Addition of several FreeBSD versions.
- r192561 that attempted to fix UTF-8 issues.

Bootstrap merge history.

Add a new library: libulog.

One of the things I really want to do, is to get rid of the limitations
of our current utmp(5) mechanism:

- It only allows 8 byte TTY device names.
- The hostname only allows 16 bytes of storage.

I'm not a big fan of <utmpx.h>, but I think we should at least try to
add parts of it. Unfortunately we cannot implement <utmpx.h>, because we
miss various fields, such as ut_id, ut_pid, etc. The API provided by
libulog shares some similarities with <utmpx.h>, so it shouldn't be too
hard to port these applications eventually. In most simple cases, it
should just be a matter of removing the ulog_ prefix everywhere.

As a bonus, it also implements a function called ulog_login_pseudo(),
which allows unprivileged applications to write log entries, provided
they have a valid file descriptor to a pseudo-terminal master device.

libulog will allow a smoother transition to a new file format by adding
a library interface to deal with utmp/wtmp/lastlog files. I initially
thought about adding the functionality to libutil, but because I'm not
planning on keeping this library around forever, we'd better keep it
separated.

Next items on the todo list:

1. Port applications in the base system (and ports) to libulog, instead
of letting them use <utmp.h>.
2. Remove <utmp.h>, implement <utmpx.h> and reimplement this library on
top.
3. Port as many applications as possible back to <utmpx.h>.

When man pages are formatted in UTF-8, .Fl is encoded as U+2212 "MINUS
SIGN" instead of U+002D "HYPHEN-MINUS". This is unfortunate for two
reasons: 1) this is not the character which is actually used on the
command line, and 2) it makes it impossible to search a man page for a
specific command-line option.

This patch fixes this, but there are other unresolved issues, such as
confusion between -, \- and hy: while the latter is always (and only)
used for hyphenation, both - and \- are used for negation and
subtraction, and \- is used for command-line options and sometimes
also for parenthesis. IMHO, the correct Unicode characters are:

- hyphenation: either U+2010 or U+00AD, most likely the former (the
latter is the so-called soft hyphen, used to indicate a point at
which a text processor is allowed to hyphenate a word)

- negation and subtraction: U+2212

- parenthesis: in English, U+2214, with spaces suppressed before and
after; in some others (such as Norwegian), U+2213 with spaces
retained.

- command-line options: U+002D, because that is what is actually used
on the command line.

However, fixing this would require extensive modifications to (at least)
the doc and man macro sets...

MFC after: 1 week

Remove empty directories from the HEAD.

Discussed with: developers, imp

These directories have been empty since 2001, and are not present in the
vendor tree.

MFC after: 1 week

MFV: recent mdoc(7) changes.

Approved by: re (kensmith)

This commit was generated by cvs2svn to compensate for changes in r172423,
which included commits to RCS files with non-trunk default branches.

MFV: Sync with vendor branch.

This commit was generated by cvs2svn to compensate for changes in r165538,
which included commits to RCS files with non-trunk default branches.

Pull up from the FSF branch.

This commit was generated by cvs2svn to compensate for changes in r154258,
which included commits to RCS files with non-trunk default branches.

Update upgrade instructions.

Merge Groff 1.19.2 changes.

Use stock (FSF) version of this file.

This commit was generated by cvs2svn to compensate for changes in r151500,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r151497,
which included commits to RCS files with non-trunk default branches.

MFV: Latest mdoc(7) fixes.

This commit was generated by cvs2svn to compensate for changes in r140801,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r140229,
which included commits to RCS files with non-trunk default branches.

Revert rev 1.66. This file needs to track its upstream source.

Requested by: ru

Support for ".Fx 6.0".

Reviewed by: ru

This commit was generated by cvs2svn to compensate for changes in r136136,
which included commits to RCS files with non-trunk default branches.

Sync with FSF.

This commit was generated by cvs2svn to compensate for changes in r132873,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r130457,
which included commits to RCS files with non-trunk default branches.

Pull up latest mdoc(7) changes:

: 2004-04-14 Thomas Klausner <wiz@netbsd.org>
:
: * tmac/doc-common (doc-volume-as-*): Use lowercase names.
: (doc-operating-system-*): Updated.
: * tmac/doc-syms (doc-str-St-*): Various small fixes.
: (doc-str-Lb-*): Add more library names.

Back out getopt* adding here per maintainer request

Remove unneeded files

MFV: The -d option.

Sort encodings.

Sync with FSF branch.

This commit was generated by cvs2svn to compensate for changes in r120297,
which included commits to RCS files with non-trunk default branches.

Unbreak Russian KOI8-R support.

This commit was generated by cvs2svn to compensate for changes in r117264,
which included commits to RCS files with non-trunk default branches.

MFV.

This commit was generated by cvs2svn to compensate for changes in r117201,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r117153,
which included commits to RCS files with non-trunk default branches.

FreeBSD now has the locale(1) utility.

This commit was generated by cvs2svn to compensate for changes in r115984,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r115982,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r115155,
which included commits to RCS files with non-trunk default branches.

MFV:

- Do not emit multiple empty lines in the CRT mode.
- Fixed the Nd macro to use the right dash.

Update upgrade instructions.

Merge local changes (8 bit clean ctype support) onto mainline.

Merge Groff 1.19 changes.

Use stock (FSF) version of this file.

Removed yacc(1) output files.

This commit was generated by cvs2svn to compensate for changes in r114405,
which included commits to RCS files with non-trunk default branches.

Removed files not present in v1.19 import.

This commit was generated by cvs2svn to compensate for changes in r114402,
which included commits to RCS files with non-trunk default branches.

Use the stock (FSF) version of this file.

Moved the libugidfw library definition out from contributed source
to where it actually belongs.

Submitted by: phantom

Add an entry for libugidfw.

Sponsored by: DARPA, Network Associates Laboratories

A version of SGR disabling stuff that is believed to be safe.

Submitted by: Werner LEMBERG <wl@gnu.org>

A crude temporary hack to fix building of ms(7) formatted documents
while I am working on a real fix.

A better version of disabling SGR support in grotty(1).

Disable SGR support in grotty(1) pending the resolution on -arch.

This commit was generated by cvs2svn to compensate for changes in r105151,
which included commits to RCS files with non-trunk default branches.

Merge FSF changes onto mainline (-r option).

This commit was generated by cvs2svn to compensate for changes in r105081,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r104912,
which included commits to RCS files with non-trunk default branches.

Update for Groff 1.18.1.

New Russian hyphenation patterns from the teTeX distribution.
Use the new .hpfa request to append them to English patterns.

illegal.cc was renamed to invalid.cc. Bring in the fix
that makes almost all characters above 128 "valid".

Merge Groff 1.18.1 changes.

Use stock (FSF) version of this file.

This commit was generated by cvs2svn to compensate for changes in r104865,
which included commits to RCS files with non-trunk default branches.

Removed files not present in v1.18.1 import.

This commit was generated by cvs2svn to compensate for changes in r104862,
which included commits to RCS files with non-trunk default branches.

MFV:

- Suppress additional whitespace after the subsection header (.Ss).
(This affects a tiny number of our manpages.)

- Allow for a layout customization of the OS name in the document
title (.Dt). (Needed for Russian and French manpages.)

FreeBSD 4.6, 4.6.2, 4.7 and 4.8 are now officially supported in -mdoc.

Move the definition of FreeBSD 4.6 back to where it belongs.

Revert last change.

Requested by: ru

Teach mdoc about FreeBSD 4.6.1

Teach mdoc about the 4.6 release

MFV: Initialize %I register.

This commit was generated by cvs2svn to compensate for changes in r89500,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r89397,
which included commits to RCS files with non-trunk default branches.

MFV: NetBSD style document titles (OS/arch).

This commit was generated by cvs2svn to compensate for changes in r89232,
which included commits to RCS files with non-trunk default branches.

MFV: FreeBSD 4.4, FreeBSD 4.5, NetBSD 1.6, POSIX.1-2001.

This commit was generated by cvs2svn to compensate for changes in r88345,
which included commits to RCS files with non-trunk default branches.

MFV: Handle long document titles better.

This commit was generated by cvs2svn to compensate for changes in r85552,
which included commits to RCS files with non-trunk default branches.

MFV: New macro: .Ex.

This commit was generated by cvs2svn to compensate for changes in r81682,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r81630,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r79847,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r79655,
which included commits to RCS files with non-trunk default branches.

Merge Groff 1.17.2 changes.

Use stock (FSF) version of this file.

This commit was generated by cvs2svn to compensate for changes in r79546,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r79543,
which included commits to RCS files with non-trunk default branches.

This commit was generated by cvs2svn to compensate for changes in r78460,
which included commits to RCS files with non-trunk default branches.

Understand new locale names and Latin15 too

Fix usage of GROFF_BIN_PATH.

Update upgrade instructions.

FreeBSD provides its own version of this OS-specific file.

Removed yacc(1) output files.

Merge Groff 1.17 changes.

Use stock (FSF) version of this file.

This commit was generated by cvs2svn to compensate for changes in r75587,
which included commits to RCS files with non-trunk default branches.

Removed files not present in v1.17 import.

This commit was generated by cvs2svn to compensate for changes in r75584,
which included commits to RCS files with non-trunk default branches.

psroff(1) has never been a part of Groff.

Merge in latest CSRG revisions:

- .Fn and .Fc now print a final semicolon (`;') after a
function declaration in the SYNOPSIS
- .%I implemented
- .At outputs ``AT&T UNIX'' if called without arguments
- minor cleanup

Obtained from: CSRG archives

Record -lposix1e death.

.St macro cleanup:

- spell the abbreviation of 1003.1 as ``POSIX.1''
- fixed the description of -p1003.1-90; it was sold as ISO/IEC 9945-1:1990
- removed -p1003.1b; it only existed as 1003.1b-1993 (-p1003.1b-93), and
is part of 1003.1 since 1003.1-1996.
- replaced -p1003.1g (project) with -p1003.1g-2000 (approved draft)
- changed abbreviation of -isoC from ``ISO C'' to ``ISO C89''
- removed -iso9899 alias for -isoC
- IEC was missing from some names
- added abbreviation for -susv2 (``SUSv2'')

setlocale(3) has been fixed to match POSIX standard:
LC_ALL takes precedence over other LC_* envariables.

Fixed undesirable hyphenation on the dash of a flag argument.
Example:

.Sh SYNOPSIS
.Nm natd
.Fl unregistered-only
.Fl proxy-only
.Fl deny-incoming
.Fl use-sockets
.Fl same-ports

Ported from: mdocNG

Fixed two bugs with -tag lists.

If the -tag list definition didn't have a -width modifier,
the first .It call was supposed to set the width depending
on the first argument type; if it is a macro name, use the
macro's width value; otherwise, use width value of `No'.

The following two lists should produce identical output:

.Bl -tag -width Er -compact
.It Er EINVAL
invalid argument
.El
.Bl -tag -compact
.It Er EINVAL
invalid argument
.El

If the outermost -tag list definition did't have a -width
modifier, the .It elements of inner lists might not work
(producing a list where each successive element `walks' to
the right).

Example:

.Bl -tag -compact
.It outer
.It outer
.Bl -tag -compact
.It inner
.It inner
.El
.It outer
.It outer
.El

Ported from: mdocNG

Synch with NetBSD and OpenBSD: replace -iso9945-1 with -p1003.1-96.

Revert part of rev 1.2: make -ansiC equivalent to -ansiC-89.

Do not output extra space after .Ef call.

Ported from: mdocNG

Make ``groff -man'' work again for both man(7) and mdoc(7) manpages.
The new Groff release will support this feature.

Requested by: peter

Do not output extra comma before "and" for references with two authors.

Example:
.Rs
.%A Author1
.%A Author2
.%B Book
.Re

Produced:
Author1, and Author2, Book.

Now produces:
Author1 and Author2, Book.

Ported from: mdocNG

1. Disable the recognition of the last dot character in the
default .Ar argument as an end-of-sentence character.

Example:
.Ar
foo
Produced:
file ... foo
Now produces:
file ... foo

2. Fixed an off-by-one bug in the .It macro for the -hang lists.

Example:
.Bl -hang -width 8n -compact
.It 1234
OK
.It 1234567
OK
.It 12345678
BUG
.El
Produced:
1234 OK
1234567 OK
12345678 BUG
Now produces:
1234 OK
1234567 OK
12345678 BUG

Ported from: mdocNG

Fixed the .St strings so that no single-character component of
the name could be wrapped, e.g. ``ISO C'' is always printed on
the same line.

Ported from: mdocNG

Fixed the .Xr macro so that it produces the right spacing
and no hyphenation is possible on a dash (`-') character.

Ported from: mdocNG

1. Disable hyphenation on a dash (`-') character in macro arguments.
2. Disable recognition of end-of-sentence characters in text-type
macro arguments.
3. Fix the missing space bug when an end-of-sentence character was
followed by another punctuation character.
4. Fix the bug where hyphenation was left disabled after .Re.

Obtained from: mdocNG

Add a missing line-break request so that -ragged
-compact lists always start from the new line.

Example:

foo
.Bd -ragged -compact
bar
.Ed

Produced:

foo bar

Now produces:

foo
bar

Make the exclamation mark (`!') a recognizable punctuation character.

Obtained from: mdocNG

Add entry for libcipher.

-pthread -> -lc_r

Add librpcsvc.

Reduce diffs (mostly whitespace) to mdocNG.

Obtained from: mdocNG through NetBSD

Make .Ft and .Vt macros accept punctuation characters as
arguments, make .Vt usable outside the SYNOPSIS section.

Obtained from: mdocNG (not yet submitted for inclusion)

Fixed the ``undesirable hyphenation'' problem, most noticeable with Xr.

Obtained from: mdocNG

Fixed the bug in D1 macro where it would eat its first (text) argument.

Obtained from: mdocNG

Fixed the ``no space after a .Fl'' problem.

Example:

.Fl flag .
The space is missing.

Obtained from: mdocNG

Prepare for FreeBSD 4.3, we already have the manpage that refers to it.

Do not duplicate our efforts checking FreeBSD version. For a new version,
simply define the empty string before the .Fx macro definition, like this:

.ds Fx*4.3

Install the stock (as supplied by groff(1) distribution) tmac.an
and tmac.andoc files. The man(1), catman(1) and bsd.man.mk have
been modified to call groff(1) with -mandoc argument.

Backout rev 1.2 (emulate `:o' and `/o' letters using 'o'),
since they are already emulated in tmac.tty-char.

Reduce the diffs with the stock (FSF) version.

Backout rev 1.2 (workaround for gcc 2.60 expression evaluation
bug) as later versions of gcc have apparently this bug fixed.

Use stock (FSF) version of this file.

Resolve conflicts after v1.16.1 import.

Removed yacc(1) output files.

Removed files not present in v1.16.1 import.

This commit was generated by cvs2svn to compensate for changes in r69626,
which included commits to RCS files with non-trunk default branches.

Add the appropriate magic to make .Fx 4.1.1 work.

Make An macro understand two special arguments, -nosplit
and -split. See the mdoc.samples(7) manpage for details.

Reviewed by: sheldonh

Add libcompat record for .Lb macro.

While in the SYNOPSIS section, Nm macro always required an
argument to setup indentation for the rest of the synopsis
line and to automatically emit a line break for a non-first
synopsis line. It does not require it anymore.

The following now works as expected:

.Sh NAME
.Nm utility
.Sh SYNOPSIS
.Nm
.Cm start
.Nm
.Cm stop

Fixed Nm macro so that it accepts punctuation characters as argument.
For example, neither of the following worked before:

.Nm , name,
.Nm . name.
.Nm : name:
.Dq Nm ``name''
.Op Nm . [name].

Make the question mark (`?') a valid punctuation character.
One can now, for example, write:

.Sh EXAMPLES
Have you read the
.Xr mdoc 7 ?
.Pp
Do you like
.Fx ?

The mdoc.samples(7) page has been automatically updated to
record this change.

Fix problem with extra space after an Xr, because aZ was being called twice.
Fix the no-space-after-a-period-in-macro problem.

Obtained from: NetBSD

Fixed the last-minute bug I have made in previous revision (.ie -> .if).

Really make the Fx macro parsed and callable.

Cleaned up the .St macro.

Obtained from: NetBSD

Add a macro for ISO C99 ("isoC-99").

Fix the `missing footer' problem. See the comment for details.

Obtained from: NetBSD

Removed files not present in v1_15 import.

Fixed the `mysterious blank lines' problem. This was due to unconditional
use of the .ne requests. groff(1) apparently inserts some virtual trap at
the end of each page, and this was causing the .ne request to output extra
lines. Solution is to only use them in troff mode.

Also fixed a related bug in .It macros, where it would insert a page break
in the middle of a sentence.

Removed the end of page trap in nroff mode, as this causes .sp requests to
sometimes eat the space due to the nearby trap.

Removed blank line that appeared as the first line on each nroff-formatted
manual page.

Obtained from: NetBSD

Teach .Fx and .Os about FreeBSD 4.2.

Add libusb record for .Lb macro

s/Diggest/Digest/

Remove stale file - moved to new location

Update my copyright. Add license.

Set `Er' default value to 17n (length("EPROTONOSUPPORT") + 1)

Discussed long time ago at -committers

Add libipsec to the list of known libraries for .Lb macro

Fix typo

Noticed by: jasone

Suggest to use -pthreads instead of -lc_r

Noticed by: John-Mark Gurney <gurney_j@efn.org>

Add note about synchronization of .Lb macro code and its section
in mdoc.samples(7)

Teach .Lb macro about other libraries.

Introduce new mdoc macro -- Lb. It will be used to define library ownership
for function. For example: for stat(2) syscall (owned by libc) we will add
following code:

.Sh LIBRARY
.Lb libc

and it will be rendered to:

LIBRARY
Standard C Library (libc, -lc)

Suggested by: mpp
Idea obtained from: NetBSD

Teach Fx and Os about FreeBSD 4.1 and FreeBSD 5.0.

Fix a problem that caused the generation of an (almost) empty first
page of -mdoc manual pages in troff mode. The problem has been
introduced in rev 1.12; apparently ending a line inside a macro
definition with \c doesn't behave as Bill expected, and troff was
fooled to believe previous output was already pending thus a new page
needed to be emitted. Using a troff comment .\" instead of \c seems
to solve this, alas the brain^Wnice sed(1) magic needs to be taught to
_not_ strip those comments now.

I think -stable is not affected by this.

The groff package is not maintained by jjc@jclark.com anymore.
Reflect this change in the upgrade file.

Fix conflicts which arose during import, also add $FreeBSD$.

This commit was generated by cvs2svn to compensate for changes in r55839,
which included commits to RCS files with non-trunk default branches.

Teach .Os macro about 3.4-RELEASE and 3.5-RELEASE.
Allow to specify major version number only (like ``.Os FreeBSD 3''.

Teach .Fx macro about 3.4-RELEASE and 3.5-RELEASE

Oops, fix typo in prev commit

Don't set \(hy to char173 for koi8-r

Mention -p and -t options.

Learn nroff about -p and -t options. It allows to preprocess
file with pic(1) and tbl(1).

Not objected to: mpp

moved to tmac/locale

Allow .Rv macro to be used in 7th section also. This patch
will fix "Usage: .Rv ..." error at mdoc.samples.7

Ok'ed by: mpp

Allow "Alpha" as 2nd argument for .Dt macro. So, we can go
with "Alpha architecture" manpages.

pick up locales from locale subdir

Submitted by: "Alexey Zelkin" <phantom@crimea.edu>

koi8-r mandoc tweaks

Submitted by: "Alexey Zelkin" <phantom@crimea.edu>

source hyphen.us-ru from locale subdir

Add FreeBSD 3.3 to the Fx and Os macros.

Tune table since 0200-0206 is not available, add more chars

bad news: chars 0200-0206 used internally in troff, make them back illegal

make all chars above 127 legal

change prev. commit: emulate latin1 on ascii if latin1 chars are
in the text as groff authors suppose

Add more koi8-r chars

Pick hardcoded latin1 chars definitions only if -Tlatin1

Sense $LANG only if $LC_CTYPE is not set

Teach the .At macro about releases v2, v3, v4, and v5 of AT&T UNIX.

Force safer mode of operation for man's use of *roff.

Obtained from: OpenBSD's nroff.sh 1.2 by aaron@openbsd.org

Fix -T doubling

Add 3.2 to the list of legal FreeBSD versions for the .Os FreeBSD macro.

Add 3.2 to the list of legal FreeBSD versions for the .Fx macro.

Complete the list of FreeBSD version numbers accepted by the .Fx macro.

PR: docs/11705
Submitted by: Stephen J. Roznowski <sjr@home.net>

Fix conflicts.

This commit was generated by cvs2svn to compensate for changes in r44777,
which included commits to RCS files with non-trunk default branches.

Make .Os behave as defined (unrecognized arguments displayed as given).
Add a warning for unknown BSD versions.
Make ".Os FreeBSD" work without a warning (fix bug in previous commit).

Change .Fx macro to always display "FreeBSD" and its argument, whether
the argument is a known FreeBSD version or not.
Output an nroff error if .Fx is used with an unknown FreeBSD version.
Change .Nx and .Ox macros to always display the argument, whether
the argument is a known version or not. This eliminates much of the
need to syncrhonize .Nx and .Ox with their source OS's -- only the
exceptions (like ".Nx 1.2a" -> "NetBSD 1.2A") where the argument is
not directly copied to the output need to be added.

Always define oS to be "FreeBSD $2", no matter whether or not we
know the version number given as the argument to ".Os FreeBSD xxx".
Output nroff warning when we see a version number that we don't
know about.

- Add FreeBSD 2.2.7, 2.2.8, 3.1, and 4.0 to the Fx and Os macros.
- Add 2.2.1 and 2.2.2 missing in a couple of places too.

(This is an interim measure and a better way of redefining these macros
is in discussion.)

Correct the previous Y2K "fix". It caused man page dates to come
out like "January 19, 99+1900".

Add a macro for ISO/IEC 9945-1: 1996, the official designation of the most
recent POSIX.1 standard.

The \*(td string macro, which is supposed to display today's date in the form
"October 14, 1998". A Y2k fix makes it now display "October 14, 98+1900".
Appears you can perform arithmetic in a string definition.

PR: gnu/8321
Reviewed by: Andrew J. Korty <ajk@purdue.edu>

Add a .St -p1003.1g.

Added .St -susv2 --> Version 2 of the Single UNIX Specification

Add XPG4.2.

Fix spelling error.

PR: 6572
Submitted by: Kazuo Horikawa <horikawa@jp.freebsd.org>

Removed yacc output files so that it is impossible to mix them with
new ones that we generate.

Removed yacc output files so that it is impossible to mix them with
new ones that we generate. We used to always mix the old header with
the new .cc file. This worked because Cygnus's yacc is surprisingly
compatible with our yacc.

Add OS macros for FreeBSD 2.2.6, OpenBSD 2.2, OpenBSD 2.3.

diff to /usr/share/tmac/mdoc/mdoc-syms to accept
.Fx 2.2.1
.Fx 2.2.2
Submitted by: Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp>

Year 2000 fixes for groff
PR: 4930
Submitted by: Stephen J. Roznowski

.Ox macro needs to support "OpenBSD 2.1"

PR: docs/4561
Submitted by: Norihiro Kumagai <kuma@slab.tnr.sharp.co.jp>

Add a simple manpage.

Sense *.ISO_8859-1 and *.KOI8-R locales from environment
PR: 4290
Submitted by: "Anatoly A. Orehovsky" <tolik@www.tomsk.su>

Add a simple manpage.

add .St -p1003.1b and -p1003.1b-93

Emulate ':o' and '/o' letters using 'o'

back out rev 1.8 (last minute CDROM releases)

Add last minute CDROM releases 2.1.6.1, 2.1.7.1, 2.2.1 to macro .Fx

Add all of the pre-FreeBSD 2.0 release to the .Fx macro.

Update the usage message for the ".Bf" macro to match the actual
arguments that it takes.

Bring the .Nx (NetBSD) macro into line with NetBSD's version.

Add the .Ox (OpenBSD) macro from OpenBSD.

The .Os macro was missing 2.1.6, 2.1.7 and 3.0.
The .Fx macro was missing 2.1.7.

Add 2.2.5 to both .Os and .Fx. If I'm wrong about the version
number, no big deal - it can be removed later, but I wanted
to be able to get this into 2.2 so that when I'm using a
2.2 system ome months down the line, man pages intended for (what I
think will be the next 2.2 release) will be formatted properly.

Also fix a typo in a comment.

Revert a $FreeBSD$ to $Id$ (file otherwise modified)

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.

Change the description for section 4 to read:

Kernel Interfaces Manual

This was needed because of a few man pages like keyboard(4)
which caused the header to become unreadable with the longer
description.

a uniq name for every manpage section in header macro .Dt

Teach mdoc macros to recognize section 9 and the i386 architecture.

Use LANG=C, LC_CTYPE=C, LC_TIME=C

Understand ru_RU too

add FreeBSD 2.1.6 and 3.0 for .Fx macro

Don't mention tcpdump; this is for groff.

Import Nx macro - NetBSD

Obtained from: NetBSD

Fix latin1 guessing
Add koi8-r guessing

Look for old "man" macros in tmac.groff_an

Add setlocale LC_CTYPE and 8 bit clean ctype support.

Original author: ache

Workarround for gcc 2.60 expression evaluation bug.

Improve .Os macro support (parts obtained from 4.4Lite2 and NetBSD)

Add the .Fx macro for specifying FreeBSD releases.

Add a bunch of missing standards to the .St macro.

Add Version 1 AT&T UNIX to .At macro

Updated the ".St -ansiC" macro to report "ISO 9899: 1990 (``ISO C'')"
You can also specify -iso9899, or -isoC. Use -ansiC-89 if you still need
the X3.159-1989 string reported.

Original author: mpp

Manual page cleanups.

Original author: mpp

Install additional S and L text fonts, needed for BSD doc formatting.

Original author: ache

Add Russian language / koi8-r font support.

Original author: ache

Add psroff command

Commit import instructions for future maintainers

This commit was generated by cvs2svn to compensate for changes in r18099,
which included commits to RCS files with non-trunk default branches.