Restore the MKGROFF=bo MKCXX=yes build

Mark the documentation in dc(1), gprof(1), rogue(6) and fsck_ffs(8) with
the .roff flag in SUBDIR.

Sponsored by <The NetBSD Foundation>

branches: 1.29.22;
Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.

Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.

branches: 1.27.74; 1.27.86;
Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

Re-enable binutils-based gprof for i386, and disable old gprof on i386.

binutils gprof doesn't support mips. Build a.out gprof on mips, to support
kernel profiling.

don't install in /usr/share if NOSHARE is defined

More table-driven changes for different toolchains:
* new bsd.own.mk variable OBJECT_FMT with values "a.out" or "ELF".
* use OBJECT_FMT in Makefile tests that depend on toolchain.
* Add new bsd.own.mk variable NOSHLIB that, if set indicates a given
port doesnt yet do shared libraries. Set on powerpc.
* Document new feature-test variables in src/share/mk/bsd.README.
Tested on i386, mips, fakedup Alpha environment.

Remove WARNS= 0 from HEAD.

Descend into gprof on all ports to build doc/psd/18.gprof.
Don't define PROG in gprof on ELF or powerpc.
Put back WARNS= 0 for compatibility with 1.3.1.

WARNSify

use CPPFLAGS instead of CFLAGS

branches: 1.18.2;
use WARNS=0 not WARNS?=0 to disable warnings

Use bsd.subdir.mk as appropriate.

- Makefile cleanups

Use ${INSTALL}.

add -D${MACHINE_ARCH} to cflags; machines with new cpp predefs need it.

clean up RCS ids

deal with new share/doc strategy

update for new doc-make/install strategy

clean up import, etc.

get it to compile, with new location of gmon.h

kill bogus install -d's, and clean slightly

update for MACHINE_ARCH

Always use `install -d' to make sure destination directory exists & has
correct ownership and permissions.

changes from 0.9-ALPHA2 to 0.9-BETA

Add RCS indentifiers.

branches: 1.3.2;
fix -I for csu change.

make sure /usr/share/misc exists before installing into it.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

add alpha support files.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

add alpha support files.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

remove register

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

Cleanup for GCC 2.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

Initial commit of the machine dependant gprof files for the arm32 port.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

Initial commit of the machine dependant gprof files for the arm32 port.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

avoid extraneous gcc warnings.

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

xref moncontrol(3) instead of obsolete monitor(3), sort xrefs

xref exit(3) not exit(2)

milliseconds, not milleseconds

Describe PROFDIR environment variable

clean up RCS ids

clean up import, etc.

Fix spelling errors.

Add RCS indentifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

remove register

WARNSify

let the flat profile ignore symbols specified with -E.

clean up RCS ids

sparc handles `-c'.

Fix RCS id format.

At least prevent SIGBUS'es on so called functions (strings in text space).

clean up import, etc.

Add RCS identifiers.

Cleanup for GCC 2.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

Kluge to make the build not bomb out in here.

WARNSify

Include arm32.h when required.

alphabetize machine includes, add alpha

clean up RCS ids

another missing pc532/ns32k #if

clean up import, etc.

get it to compile, with new location of gmon.h

#if <arch_name> -> #ifdef <arch_name>, per suggestion by phil.

Adding the ns32k support. Currently just a copy of the i386 files.

update for MACHINE_ARCH

Another dummy call graph module.

Add RCS identifiers.

Cleanup for GCC 2.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Clean up deleted files.

Add RCS identifiers, remove some completely useless RCS logs and patchkit
headers, and a few other insignificant changes.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Clean up deleted files.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers, remove some completely useless RCS logs and patchkit
headers, and a few other insignificant changes.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

remove register

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

update for MACHINE_ARCH

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

update for MACHINE_ARCH

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

remove register

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

branches: 1.1.1;
Initial revision

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

branches: 1.1.1;
Initial revision

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

clean up RCS ids

Fix RCS id format.

Adding the ns32k support. Currently just a copy of the i386 files.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

Adding the ns32k support. Currently just a copy of the i386 files.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

remove register

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

Kluge to make the build not bomb out in here.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

Kluge to make the build not bomb out in here.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

remove register

avoid extraneous gcc warnings.

WARNSify

let the flat profile ignore symbols specified with -E.

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

remove register

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

branches: 1.1.1;
Another dummy call graph module.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

branches: 1.1.1;
Another dummy call graph module.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

WARNSify

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

Fix erroneous prototypes.

WARNSify

Updated to work correctly, pointed out by Tom Ivar Helbekkmo.

clean up RCS ids

Fix RCS id format.

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Goodbye, Berkeley gprof; we shall miss you!
(PSD doc remains here, as it has not lost relevance.)

clean up RCS ids

clean up import, etc.

Add RCS identifiers.

branches: 1.1.1;
pulled in from net/2. should work fine -- profiling support exists.

Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.

Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.

branches: 1.6.62; 1.6.74;
Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.

Add ${MACROS} to ${ROFF} usage to make output readable

from jbernard@mines.edu in misc/19685

Work with obj directories

clean up RCS ids

Don't forget to install .pic files.

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

clean up RCS ids

branches: 1.1.1;
Initial revision