grammar fix; from S M

Add some references, most of these were removed when we stopped building
and installing USD/SMM/PSD docs.

jmc@ agrees with the direction, ok millert@ on an earlier diff

In addresses, consistently use "+" rather than ".+1".
Both have the same meaning, but the former is explicitly defined
in this manual page as "the next line" whereas the latter requires
combining various pieces of information for understanding.
Unification suggested and patch OK'ed by martijn@.

1. Correct the description of the g command to match POSIX and our
implementation; it was oversimplified and arguably incorrect.
2. Explicitely compare the behaviour of empty command lists for g,
empty command lists for G, and empty commands because these subtle
differences are quite confusing.
3. Say more precisely what the v and V commands do, avoiding the
fuzzy wording "similar".
All these issues were first pointed out by martijn@.
Feedback and OK martijn@; "diff reads ok" jmc@ on an earlier version.

Explain in which circumstances trailing slashes can be omitted after
the g and G commands, and polish the wording a bit explaining empty
command lists.
Closing a gap in the manual reported by <mazocomp at disroot dot org>.
OK jmc@ martijn@

Minor polishing:
* Delete a stray blank from the command line synopsis
and add the missing .Ar markup to it.
* Do not mention the terminating newline for the empty command
since it isn't mentioned for any other command either.
* Make the description of the empty command easier to understand.
Joint work with martijn@ and jmc@.

document the dropping of the second / and ? in line address REs;
thread started by mazocomp; diff from ropers, shortened by me;

ok martijn schwarze

Make ed's 'l' command end lines with a '$' and make sure that literal
'$' characters are escaped, so that we are POSIX compliant.

The omission of trailing '$' was originally hidden behind a BACKWARDS
flag. This flag was most likely introduced to be compatible with 4.4BSD.
Thanks to naddy@ for pointing me to the 4.4BSD ed implementation.

I tried to trace the origin and enabling of the BACKWARDS flag, since
both FreeBSD and NetBSD have the flag, but only FreeBSD doesn't have it
enabled. Both projects had an alm@ working on ed during 1993-1995 during
which he added this flag to both projects and only enabled it on NetBSD,
but I wasn't able to reach him on any known address.
Thanks to Ed Schouten (ed@freebsd), and Michael W. Lucas of the ed
Mastery book for helping me trying to locate Andrew Moore.

Problem originally prodded by garzon.lucero@gmail.com and later
independently re-requested by n.reusse@hxgn.net.

OK tb@, guenther@, and mwl@mwl.io

nits about trailing punctuation found with mandoc -Tlint

remove the note about the list command (l) displaying a --More--
prompt for huge lines (according to otto this happens only when
BACKWARDS is not defined);

ok otto

honestly i think you should just zap that paragraph - it doesn;t make
sense to document that posix more or less says something should happen,
and that it does.

jmc

make ed restore the user defined prompt (specified with -p) when it was turned
off and then on again with 'P'.

ok daniel@

Avoid .Ns right after .Pf, it's pointless.
In some cases, do additional cleanup in the immediate vicinity.

theo buehler points out that posix specifies a prompt defined using -p
be reinstated when toggled off then on again; this seems to make sense,
but posix is not explicit.

we know that gnu ed and freebsd do reinstate the user defined prompt, but
we do not. no one has yet stepped up to change this, so i'm adding a note
to this effect until such a time as we do/

i have not tweaked the text for -p or "P" to allow for an easy back out
if behaviour does change;

document some more commands that are POSIX extensions. ok jmc@

document in STANDARDS that we do not mark eols with $;
originally reported by ezequiel garz?n

more x removal;

remove nonstandard DES support because DES. ok beck deraadt miod

add an ASYNCHRONOUS EVENTS section for signals, as per vi;
ok millert

STANDARDS:
- `%' is an extension
- `^' is neither required nor prohibited by posix
- the deprecated `-' option is "behaviour unspecified"

ok millert

add an EXIT STATUS section for /bin;

properly escape some "!"; reported by kristaps

move exit returns blurb out of DIAGNOSTICS; from daniel dickman

remove references to docs we no longer install;

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

for the `g' and `G' commands, document that if no lines match
the regular expression then the current line number remains unchanged;

convert to new .Dd format;

- consistent STANDARDS blurb
- note which options are extensions to POSIX

discussed w/ deraadt otto millert

remove the section on regular expressions - instead point people
to re_format.7 (which is where the list of BREs went);

also, rename LIMITATIONS to CAVEATS, as this is a standard mdoc thing,
and shuffle it to the end of the page;

correct path to usd docs;

some typos and macro simplification;

make references to USD docs clearer;

sort options, and adjust -width of options' list;

replace .Em with more appropriate macros. some other cleanup;

escape punctuation;
ok deraadt@

USD docs for ed are 9-10, not 12,13;

- section reorder
- correct macro
- escape some whitespace

typos;

suggestions, corrections and ok millert@

copyrights added;

ed(1): Andrew Moore
patch(1): Larry Wall (thanks espie@ for help with this one)
units(1): Adrian Mariano

wrong word; cjeker@diehard.n-r-g.com

Unbreak. We have situations where last space in the line is required.
From dfa@openbsd.ru

Mention deprecated '-' flag (same as -s) since it is listed in the
SYNOPSIS.

Initial patch for a new mdoc issue.
Powered by @mantoya:
o) kill extra line in the end of file;
o) kill extra space in the end of line;
o) replace blank lines with .Pp;

millert@ ok

o) start new sentence on a new line;
o) don't use .Pp before/after .Ss;
o) wrap long lines;
o) fix bogus .Xr usage;

millert@ ok;

we don't like:
o) .Pp before/after .Sh;
o) .Pp before/after .Rs/.Re;
o) .Nm without argument in SYNOPSIS;

ok, tmac is now fixed

join .%A entries; most by bk@rt.fm

Various fixes; mpech@prosoft.org.lv

- Some section shuffling: conform to the standard order documented in mdoc(7)
- .Sh AUTHOR -> .Sh AUTHORS

Insert some missing commas.

- Get rid of more short lines.
- Fix a formatting error I missed in the last commit.

- Fix numerous formatting glitches.
- Convert plain reference to an mdoc macro'd reference.
- Get rid of some annoying short lines, which make the man src hard to read.
- parenthesis -> parentheses

Some fixups.

Don't hyphenate the words {left|right}most.

Mostly punctuation fixes.

Add HISTORY sections; from FreeBSD. Information originally obtained from
"A Quarter Centry of UNIX, Peter H. Salus, Page 41".

Remove hard sentence breaks.

trash some old leftover macros and replace them with -mdoc macros

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

fix a command sequence description; d@, also some misc cleanup

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

start killing redundant .Nm macro arguments (mandoc ``remembers'' the first one
it's given)

use .Dq/.Sq macros instead of `` ''s and ` 's (think typesetting and future
processing); kill redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and numerically order according to section

First complete sweep of man pages, bin/. Command/function names previously
(incorrectly) capatilized are fixed. Comma splices, hyphenations, SYNOPSIS
cleanups, other miscellaneous typos.

more man page fixes; aaron@ug.cs.dal.ca

fix +n description; jkoshy@freebsd

man page error; helbig

minor errors; josh@quick.net

bad Ns

more Ns

oops. ok, why does my footer not show up yet??

roughly 3 hours of slaving results in a much more beautiful mdoc man page.

"the the" purge

update rcsid

branches: 1.1.1;
Initial revision

Add some references, most of these were removed when we stopped building
and installing USD/SMM/PSD docs.

jmc@ agrees with the direction, ok millert@ on an earlier diff

In addresses, consistently use "+" rather than ".+1".
Both have the same meaning, but the former is explicitly defined
in this manual page as "the next line" whereas the latter requires
combining various pieces of information for understanding.
Unification suggested and patch OK'ed by martijn@.

1. Correct the description of the g command to match POSIX and our
implementation; it was oversimplified and arguably incorrect.
2. Explicitely compare the behaviour of empty command lists for g,
empty command lists for G, and empty commands because these subtle
differences are quite confusing.
3. Say more precisely what the v and V commands do, avoiding the
fuzzy wording "similar".
All these issues were first pointed out by martijn@.
Feedback and OK martijn@; "diff reads ok" jmc@ on an earlier version.

Explain in which circumstances trailing slashes can be omitted after
the g and G commands, and polish the wording a bit explaining empty
command lists.
Closing a gap in the manual reported by <mazocomp at disroot dot org>.
OK jmc@ martijn@

Minor polishing:
* Delete a stray blank from the command line synopsis
and add the missing .Ar markup to it.
* Do not mention the terminating newline for the empty command
since it isn't mentioned for any other command either.
* Make the description of the empty command easier to understand.
Joint work with martijn@ and jmc@.

document the dropping of the second / and ? in line address REs;
thread started by mazocomp; diff from ropers, shortened by me;

ok martijn schwarze

Make ed's 'l' command end lines with a '$' and make sure that literal
'$' characters are escaped, so that we are POSIX compliant.

The omission of trailing '$' was originally hidden behind a BACKWARDS
flag. This flag was most likely introduced to be compatible with 4.4BSD.
Thanks to naddy@ for pointing me to the 4.4BSD ed implementation.

I tried to trace the origin and enabling of the BACKWARDS flag, since
both FreeBSD and NetBSD have the flag, but only FreeBSD doesn't have it
enabled. Both projects had an alm@ working on ed during 1993-1995 during
which he added this flag to both projects and only enabled it on NetBSD,
but I wasn't able to reach him on any known address.
Thanks to Ed Schouten (ed@freebsd), and Michael W. Lucas of the ed
Mastery book for helping me trying to locate Andrew Moore.

Problem originally prodded by garzon.lucero@gmail.com and later
independently re-requested by n.reusse@hxgn.net.

OK tb@, guenther@, and mwl@mwl.io

nits about trailing punctuation found with mandoc -Tlint

remove the note about the list command (l) displaying a --More--
prompt for huge lines (according to otto this happens only when
BACKWARDS is not defined);

ok otto

honestly i think you should just zap that paragraph - it doesn;t make
sense to document that posix more or less says something should happen,
and that it does.

jmc

make ed restore the user defined prompt (specified with -p) when it was turned
off and then on again with 'P'.

ok daniel@

Avoid .Ns right after .Pf, it's pointless.
In some cases, do additional cleanup in the immediate vicinity.

theo buehler points out that posix specifies a prompt defined using -p
be reinstated when toggled off then on again; this seems to make sense,
but posix is not explicit.

we know that gnu ed and freebsd do reinstate the user defined prompt, but
we do not. no one has yet stepped up to change this, so i'm adding a note
to this effect until such a time as we do/

i have not tweaked the text for -p or "P" to allow for an easy back out
if behaviour does change;

document some more commands that are POSIX extensions. ok jmc@

document in STANDARDS that we do not mark eols with $;
originally reported by ezequiel garz?n

more x removal;

remove nonstandard DES support because DES. ok beck deraadt miod

add an ASYNCHRONOUS EVENTS section for signals, as per vi;
ok millert

STANDARDS:
- `%' is an extension
- `^' is neither required nor prohibited by posix
- the deprecated `-' option is "behaviour unspecified"

ok millert

add an EXIT STATUS section for /bin;

properly escape some "!"; reported by kristaps

move exit returns blurb out of DIAGNOSTICS; from daniel dickman

remove references to docs we no longer install;

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

for the `g' and `G' commands, document that if no lines match
the regular expression then the current line number remains unchanged;

convert to new .Dd format;

- consistent STANDARDS blurb
- note which options are extensions to POSIX

discussed w/ deraadt otto millert

remove the section on regular expressions - instead point people
to re_format.7 (which is where the list of BREs went);

also, rename LIMITATIONS to CAVEATS, as this is a standard mdoc thing,
and shuffle it to the end of the page;

correct path to usd docs;

some typos and macro simplification;

make references to USD docs clearer;

sort options, and adjust -width of options' list;

replace .Em with more appropriate macros. some other cleanup;

escape punctuation;
ok deraadt@

USD docs for ed are 9-10, not 12,13;

- section reorder
- correct macro
- escape some whitespace

typos;

suggestions, corrections and ok millert@

copyrights added;

ed(1): Andrew Moore
patch(1): Larry Wall (thanks espie@ for help with this one)
units(1): Adrian Mariano

wrong word; cjeker@diehard.n-r-g.com

Unbreak. We have situations where last space in the line is required.
From dfa@openbsd.ru

Mention deprecated '-' flag (same as -s) since it is listed in the
SYNOPSIS.

Initial patch for a new mdoc issue.
Powered by @mantoya:
o) kill extra line in the end of file;
o) kill extra space in the end of line;
o) replace blank lines with .Pp;

millert@ ok

o) start new sentence on a new line;
o) don't use .Pp before/after .Ss;
o) wrap long lines;
o) fix bogus .Xr usage;

millert@ ok;

we don't like:
o) .Pp before/after .Sh;
o) .Pp before/after .Rs/.Re;
o) .Nm without argument in SYNOPSIS;

ok, tmac is now fixed

join .%A entries; most by bk@rt.fm

Various fixes; mpech@prosoft.org.lv

- Some section shuffling: conform to the standard order documented in mdoc(7)
- .Sh AUTHOR -> .Sh AUTHORS

Insert some missing commas.

- Get rid of more short lines.
- Fix a formatting error I missed in the last commit.

- Fix numerous formatting glitches.
- Convert plain reference to an mdoc macro'd reference.
- Get rid of some annoying short lines, which make the man src hard to read.
- parenthesis -> parentheses

Some fixups.

Don't hyphenate the words {left|right}most.

Mostly punctuation fixes.

Add HISTORY sections; from FreeBSD. Information originally obtained from
"A Quarter Centry of UNIX, Peter H. Salus, Page 41".

Remove hard sentence breaks.

trash some old leftover macros and replace them with -mdoc macros

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

fix a command sequence description; d@, also some misc cleanup

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

start killing redundant .Nm macro arguments (mandoc ``remembers'' the first one
it's given)

use .Dq/.Sq macros instead of `` ''s and ` 's (think typesetting and future
processing); kill redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and numerically order according to section

First complete sweep of man pages, bin/. Command/function names previously
(incorrectly) capatilized are fixed. Comma splices, hyphenations, SYNOPSIS
cleanups, other miscellaneous typos.

more man page fixes; aaron@ug.cs.dal.ca

fix +n description; jkoshy@freebsd

man page error; helbig

minor errors; josh@quick.net

bad Ns

more Ns

oops. ok, why does my footer not show up yet??

roughly 3 hours of slaving results in a much more beautiful mdoc man page.

"the the" purge

update rcsid

branches: 1.1.1;
Initial revision

In addresses, consistently use "+" rather than ".+1".
Both have the same meaning, but the former is explicitly defined
in this manual page as "the next line" whereas the latter requires
combining various pieces of information for understanding.
Unification suggested and patch OK'ed by martijn@.

1. Correct the description of the g command to match POSIX and our
implementation; it was oversimplified and arguably incorrect.
2. Explicitely compare the behaviour of empty command lists for g,
empty command lists for G, and empty commands because these subtle
differences are quite confusing.
3. Say more precisely what the v and V commands do, avoiding the
fuzzy wording "similar".
All these issues were first pointed out by martijn@.
Feedback and OK martijn@; "diff reads ok" jmc@ on an earlier version.

Explain in which circumstances trailing slashes can be omitted after
the g and G commands, and polish the wording a bit explaining empty
command lists.
Closing a gap in the manual reported by <mazocomp at disroot dot org>.
OK jmc@ martijn@

Minor polishing:
* Delete a stray blank from the command line synopsis
and add the missing .Ar markup to it.
* Do not mention the terminating newline for the empty command
since it isn't mentioned for any other command either.
* Make the description of the empty command easier to understand.
Joint work with martijn@ and jmc@.

document the dropping of the second / and ? in line address REs;
thread started by mazocomp; diff from ropers, shortened by me;

ok martijn schwarze

Make ed's 'l' command end lines with a '$' and make sure that literal
'$' characters are escaped, so that we are POSIX compliant.

The omission of trailing '$' was originally hidden behind a BACKWARDS
flag. This flag was most likely introduced to be compatible with 4.4BSD.
Thanks to naddy@ for pointing me to the 4.4BSD ed implementation.

I tried to trace the origin and enabling of the BACKWARDS flag, since
both FreeBSD and NetBSD have the flag, but only FreeBSD doesn't have it
enabled. Both projects had an alm@ working on ed during 1993-1995 during
which he added this flag to both projects and only enabled it on NetBSD,
but I wasn't able to reach him on any known address.
Thanks to Ed Schouten (ed@freebsd), and Michael W. Lucas of the ed
Mastery book for helping me trying to locate Andrew Moore.

Problem originally prodded by garzon.lucero@gmail.com and later
independently re-requested by n.reusse@hxgn.net.

OK tb@, guenther@, and mwl@mwl.io

nits about trailing punctuation found with mandoc -Tlint

remove the note about the list command (l) displaying a --More--
prompt for huge lines (according to otto this happens only when
BACKWARDS is not defined);

ok otto

honestly i think you should just zap that paragraph - it doesn;t make
sense to document that posix more or less says something should happen,
and that it does.

jmc

make ed restore the user defined prompt (specified with -p) when it was turned
off and then on again with 'P'.

ok daniel@

Avoid .Ns right after .Pf, it's pointless.
In some cases, do additional cleanup in the immediate vicinity.

theo buehler points out that posix specifies a prompt defined using -p
be reinstated when toggled off then on again; this seems to make sense,
but posix is not explicit.

we know that gnu ed and freebsd do reinstate the user defined prompt, but
we do not. no one has yet stepped up to change this, so i'm adding a note
to this effect until such a time as we do/

i have not tweaked the text for -p or "P" to allow for an easy back out
if behaviour does change;

document some more commands that are POSIX extensions. ok jmc@

document in STANDARDS that we do not mark eols with $;
originally reported by ezequiel garz?n

more x removal;

remove nonstandard DES support because DES. ok beck deraadt miod

add an ASYNCHRONOUS EVENTS section for signals, as per vi;
ok millert

STANDARDS:
- `%' is an extension
- `^' is neither required nor prohibited by posix
- the deprecated `-' option is "behaviour unspecified"

ok millert

add an EXIT STATUS section for /bin;

properly escape some "!"; reported by kristaps

move exit returns blurb out of DIAGNOSTICS; from daniel dickman

remove references to docs we no longer install;

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

for the `g' and `G' commands, document that if no lines match
the regular expression then the current line number remains unchanged;

convert to new .Dd format;

- consistent STANDARDS blurb
- note which options are extensions to POSIX

discussed w/ deraadt otto millert

remove the section on regular expressions - instead point people
to re_format.7 (which is where the list of BREs went);

also, rename LIMITATIONS to CAVEATS, as this is a standard mdoc thing,
and shuffle it to the end of the page;

correct path to usd docs;

some typos and macro simplification;

make references to USD docs clearer;

sort options, and adjust -width of options' list;

replace .Em with more appropriate macros. some other cleanup;

escape punctuation;
ok deraadt@

USD docs for ed are 9-10, not 12,13;

- section reorder
- correct macro
- escape some whitespace

typos;

suggestions, corrections and ok millert@

copyrights added;

ed(1): Andrew Moore
patch(1): Larry Wall (thanks espie@ for help with this one)
units(1): Adrian Mariano

wrong word; cjeker@diehard.n-r-g.com

Unbreak. We have situations where last space in the line is required.
From dfa@openbsd.ru

Mention deprecated '-' flag (same as -s) since it is listed in the
SYNOPSIS.

Initial patch for a new mdoc issue.
Powered by @mantoya:
o) kill extra line in the end of file;
o) kill extra space in the end of line;
o) replace blank lines with .Pp;

millert@ ok

o) start new sentence on a new line;
o) don't use .Pp before/after .Ss;
o) wrap long lines;
o) fix bogus .Xr usage;

millert@ ok;

we don't like:
o) .Pp before/after .Sh;
o) .Pp before/after .Rs/.Re;
o) .Nm without argument in SYNOPSIS;

ok, tmac is now fixed

join .%A entries; most by bk@rt.fm

Various fixes; mpech@prosoft.org.lv

- Some section shuffling: conform to the standard order documented in mdoc(7)
- .Sh AUTHOR -> .Sh AUTHORS

Insert some missing commas.

- Get rid of more short lines.
- Fix a formatting error I missed in the last commit.

- Fix numerous formatting glitches.
- Convert plain reference to an mdoc macro'd reference.
- Get rid of some annoying short lines, which make the man src hard to read.
- parenthesis -> parentheses

Some fixups.

Don't hyphenate the words {left|right}most.

Mostly punctuation fixes.

Add HISTORY sections; from FreeBSD. Information originally obtained from
"A Quarter Centry of UNIX, Peter H. Salus, Page 41".

Remove hard sentence breaks.

trash some old leftover macros and replace them with -mdoc macros

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

fix a command sequence description; d@, also some misc cleanup

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

start killing redundant .Nm macro arguments (mandoc ``remembers'' the first one
it's given)

use .Dq/.Sq macros instead of `` ''s and ` 's (think typesetting and future
processing); kill redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and numerically order according to section

First complete sweep of man pages, bin/. Command/function names previously
(incorrectly) capatilized are fixed. Comma splices, hyphenations, SYNOPSIS
cleanups, other miscellaneous typos.

more man page fixes; aaron@ug.cs.dal.ca

fix +n description; jkoshy@freebsd

man page error; helbig

minor errors; josh@quick.net

bad Ns

more Ns

oops. ok, why does my footer not show up yet??

roughly 3 hours of slaving results in a much more beautiful mdoc man page.

"the the" purge

update rcsid

branches: 1.1.1;
Initial revision

1. Correct the description of the g command to match POSIX and our
implementation; it was oversimplified and arguably incorrect.
2. Explicitely compare the behaviour of empty command lists for g,
empty command lists for G, and empty commands because these subtle
differences are quite confusing.
3. Say more precisely what the v and V commands do, avoiding the
fuzzy wording "similar".
All these issues were first pointed out by martijn@.
Feedback and OK martijn@; "diff reads ok" jmc@ on an earlier version.

Explain in which circumstances trailing slashes can be omitted after
the g and G commands, and polish the wording a bit explaining empty
command lists.
Closing a gap in the manual reported by <mazocomp at disroot dot org>.
OK jmc@ martijn@

Minor polishing:
* Delete a stray blank from the command line synopsis
and add the missing .Ar markup to it.
* Do not mention the terminating newline for the empty command
since it isn't mentioned for any other command either.
* Make the description of the empty command easier to understand.
Joint work with martijn@ and jmc@.

document the dropping of the second / and ? in line address REs;
thread started by mazocomp; diff from ropers, shortened by me;

ok martijn schwarze

Make ed's 'l' command end lines with a '$' and make sure that literal
'$' characters are escaped, so that we are POSIX compliant.

The omission of trailing '$' was originally hidden behind a BACKWARDS
flag. This flag was most likely introduced to be compatible with 4.4BSD.
Thanks to naddy@ for pointing me to the 4.4BSD ed implementation.

I tried to trace the origin and enabling of the BACKWARDS flag, since
both FreeBSD and NetBSD have the flag, but only FreeBSD doesn't have it
enabled. Both projects had an alm@ working on ed during 1993-1995 during
which he added this flag to both projects and only enabled it on NetBSD,
but I wasn't able to reach him on any known address.
Thanks to Ed Schouten (ed@freebsd), and Michael W. Lucas of the ed
Mastery book for helping me trying to locate Andrew Moore.

Problem originally prodded by garzon.lucero@gmail.com and later
independently re-requested by n.reusse@hxgn.net.

OK tb@, guenther@, and mwl@mwl.io

nits about trailing punctuation found with mandoc -Tlint

remove the note about the list command (l) displaying a --More--
prompt for huge lines (according to otto this happens only when
BACKWARDS is not defined);

ok otto

honestly i think you should just zap that paragraph - it doesn;t make
sense to document that posix more or less says something should happen,
and that it does.

jmc

make ed restore the user defined prompt (specified with -p) when it was turned
off and then on again with 'P'.

ok daniel@

Avoid .Ns right after .Pf, it's pointless.
In some cases, do additional cleanup in the immediate vicinity.

theo buehler points out that posix specifies a prompt defined using -p
be reinstated when toggled off then on again; this seems to make sense,
but posix is not explicit.

we know that gnu ed and freebsd do reinstate the user defined prompt, but
we do not. no one has yet stepped up to change this, so i'm adding a note
to this effect until such a time as we do/

i have not tweaked the text for -p or "P" to allow for an easy back out
if behaviour does change;

document some more commands that are POSIX extensions. ok jmc@

document in STANDARDS that we do not mark eols with $;
originally reported by ezequiel garz?n

more x removal;

remove nonstandard DES support because DES. ok beck deraadt miod

add an ASYNCHRONOUS EVENTS section for signals, as per vi;
ok millert

STANDARDS:
- `%' is an extension
- `^' is neither required nor prohibited by posix
- the deprecated `-' option is "behaviour unspecified"

ok millert

add an EXIT STATUS section for /bin;

properly escape some "!"; reported by kristaps

move exit returns blurb out of DIAGNOSTICS; from daniel dickman

remove references to docs we no longer install;

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

for the `g' and `G' commands, document that if no lines match
the regular expression then the current line number remains unchanged;

convert to new .Dd format;

- consistent STANDARDS blurb
- note which options are extensions to POSIX

discussed w/ deraadt otto millert

remove the section on regular expressions - instead point people
to re_format.7 (which is where the list of BREs went);

also, rename LIMITATIONS to CAVEATS, as this is a standard mdoc thing,
and shuffle it to the end of the page;

correct path to usd docs;

some typos and macro simplification;

make references to USD docs clearer;

sort options, and adjust -width of options' list;

replace .Em with more appropriate macros. some other cleanup;

escape punctuation;
ok deraadt@

USD docs for ed are 9-10, not 12,13;

- section reorder
- correct macro
- escape some whitespace

typos;

suggestions, corrections and ok millert@

copyrights added;

ed(1): Andrew Moore
patch(1): Larry Wall (thanks espie@ for help with this one)
units(1): Adrian Mariano

wrong word; cjeker@diehard.n-r-g.com

Unbreak. We have situations where last space in the line is required.
From dfa@openbsd.ru

Mention deprecated '-' flag (same as -s) since it is listed in the
SYNOPSIS.

Initial patch for a new mdoc issue.
Powered by @mantoya:
o) kill extra line in the end of file;
o) kill extra space in the end of line;
o) replace blank lines with .Pp;

millert@ ok

o) start new sentence on a new line;
o) don't use .Pp before/after .Ss;
o) wrap long lines;
o) fix bogus .Xr usage;

millert@ ok;

we don't like:
o) .Pp before/after .Sh;
o) .Pp before/after .Rs/.Re;
o) .Nm without argument in SYNOPSIS;

ok, tmac is now fixed

join .%A entries; most by bk@rt.fm

Various fixes; mpech@prosoft.org.lv

- Some section shuffling: conform to the standard order documented in mdoc(7)
- .Sh AUTHOR -> .Sh AUTHORS

Insert some missing commas.

- Get rid of more short lines.
- Fix a formatting error I missed in the last commit.

- Fix numerous formatting glitches.
- Convert plain reference to an mdoc macro'd reference.
- Get rid of some annoying short lines, which make the man src hard to read.
- parenthesis -> parentheses

Some fixups.

Don't hyphenate the words {left|right}most.

Mostly punctuation fixes.

Add HISTORY sections; from FreeBSD. Information originally obtained from
"A Quarter Centry of UNIX, Peter H. Salus, Page 41".

Remove hard sentence breaks.

trash some old leftover macros and replace them with -mdoc macros

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

fix a command sequence description; d@, also some misc cleanup

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

start killing redundant .Nm macro arguments (mandoc ``remembers'' the first one
it's given)

use .Dq/.Sq macros instead of `` ''s and ` 's (think typesetting and future
processing); kill redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and numerically order according to section

First complete sweep of man pages, bin/. Command/function names previously
(incorrectly) capatilized are fixed. Comma splices, hyphenations, SYNOPSIS
cleanups, other miscellaneous typos.

more man page fixes; aaron@ug.cs.dal.ca

fix +n description; jkoshy@freebsd

man page error; helbig

minor errors; josh@quick.net

bad Ns

more Ns

oops. ok, why does my footer not show up yet??

roughly 3 hours of slaving results in a much more beautiful mdoc man page.

"the the" purge

update rcsid

branches: 1.1.1;
Initial revision

Explain in which circumstances trailing slashes can be omitted after
the g and G commands, and polish the wording a bit explaining empty
command lists.
Closing a gap in the manual reported by <mazocomp at disroot dot org>.
OK jmc@ martijn@

Minor polishing:
* Delete a stray blank from the command line synopsis
and add the missing .Ar markup to it.
* Do not mention the terminating newline for the empty command
since it isn't mentioned for any other command either.
* Make the description of the empty command easier to understand.
Joint work with martijn@ and jmc@.

document the dropping of the second / and ? in line address REs;
thread started by mazocomp; diff from ropers, shortened by me;

ok martijn schwarze

Make ed's 'l' command end lines with a '$' and make sure that literal
'$' characters are escaped, so that we are POSIX compliant.

The omission of trailing '$' was originally hidden behind a BACKWARDS
flag. This flag was most likely introduced to be compatible with 4.4BSD.
Thanks to naddy@ for pointing me to the 4.4BSD ed implementation.

I tried to trace the origin and enabling of the BACKWARDS flag, since
both FreeBSD and NetBSD have the flag, but only FreeBSD doesn't have it
enabled. Both projects had an alm@ working on ed during 1993-1995 during
which he added this flag to both projects and only enabled it on NetBSD,
but I wasn't able to reach him on any known address.
Thanks to Ed Schouten (ed@freebsd), and Michael W. Lucas of the ed
Mastery book for helping me trying to locate Andrew Moore.

Problem originally prodded by garzon.lucero@gmail.com and later
independently re-requested by n.reusse@hxgn.net.

OK tb@, guenther@, and mwl@mwl.io

nits about trailing punctuation found with mandoc -Tlint

remove the note about the list command (l) displaying a --More--
prompt for huge lines (according to otto this happens only when
BACKWARDS is not defined);

ok otto

honestly i think you should just zap that paragraph - it doesn;t make
sense to document that posix more or less says something should happen,
and that it does.

jmc

make ed restore the user defined prompt (specified with -p) when it was turned
off and then on again with 'P'.

ok daniel@

Avoid .Ns right after .Pf, it's pointless.
In some cases, do additional cleanup in the immediate vicinity.

theo buehler points out that posix specifies a prompt defined using -p
be reinstated when toggled off then on again; this seems to make sense,
but posix is not explicit.

we know that gnu ed and freebsd do reinstate the user defined prompt, but
we do not. no one has yet stepped up to change this, so i'm adding a note
to this effect until such a time as we do/

i have not tweaked the text for -p or "P" to allow for an easy back out
if behaviour does change;

document some more commands that are POSIX extensions. ok jmc@

document in STANDARDS that we do not mark eols with $;
originally reported by ezequiel garz?n

more x removal;

remove nonstandard DES support because DES. ok beck deraadt miod

add an ASYNCHRONOUS EVENTS section for signals, as per vi;
ok millert

STANDARDS:
- `%' is an extension
- `^' is neither required nor prohibited by posix
- the deprecated `-' option is "behaviour unspecified"

ok millert

add an EXIT STATUS section for /bin;

properly escape some "!"; reported by kristaps

move exit returns blurb out of DIAGNOSTICS; from daniel dickman

remove references to docs we no longer install;

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

for the `g' and `G' commands, document that if no lines match
the regular expression then the current line number remains unchanged;

convert to new .Dd format;

- consistent STANDARDS blurb
- note which options are extensions to POSIX

discussed w/ deraadt otto millert

remove the section on regular expressions - instead point people
to re_format.7 (which is where the list of BREs went);

also, rename LIMITATIONS to CAVEATS, as this is a standard mdoc thing,
and shuffle it to the end of the page;

correct path to usd docs;

some typos and macro simplification;

make references to USD docs clearer;

sort options, and adjust -width of options' list;

replace .Em with more appropriate macros. some other cleanup;

escape punctuation;
ok deraadt@

USD docs for ed are 9-10, not 12,13;

- section reorder
- correct macro
- escape some whitespace

typos;

suggestions, corrections and ok millert@

copyrights added;

ed(1): Andrew Moore
patch(1): Larry Wall (thanks espie@ for help with this one)
units(1): Adrian Mariano

wrong word; cjeker@diehard.n-r-g.com

Unbreak. We have situations where last space in the line is required.
From dfa@openbsd.ru

Mention deprecated '-' flag (same as -s) since it is listed in the
SYNOPSIS.

Initial patch for a new mdoc issue.
Powered by @mantoya:
o) kill extra line in the end of file;
o) kill extra space in the end of line;
o) replace blank lines with .Pp;

millert@ ok

o) start new sentence on a new line;
o) don't use .Pp before/after .Ss;
o) wrap long lines;
o) fix bogus .Xr usage;

millert@ ok;

we don't like:
o) .Pp before/after .Sh;
o) .Pp before/after .Rs/.Re;
o) .Nm without argument in SYNOPSIS;

ok, tmac is now fixed

join .%A entries; most by bk@rt.fm

Various fixes; mpech@prosoft.org.lv

- Some section shuffling: conform to the standard order documented in mdoc(7)
- .Sh AUTHOR -> .Sh AUTHORS

Insert some missing commas.

- Get rid of more short lines.
- Fix a formatting error I missed in the last commit.

- Fix numerous formatting glitches.
- Convert plain reference to an mdoc macro'd reference.
- Get rid of some annoying short lines, which make the man src hard to read.
- parenthesis -> parentheses

Some fixups.

Don't hyphenate the words {left|right}most.

Mostly punctuation fixes.

Add HISTORY sections; from FreeBSD. Information originally obtained from
"A Quarter Centry of UNIX, Peter H. Salus, Page 41".

Remove hard sentence breaks.

trash some old leftover macros and replace them with -mdoc macros

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

fix a command sequence description; d@, also some misc cleanup

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

start killing redundant .Nm macro arguments (mandoc ``remembers'' the first one
it's given)

use .Dq/.Sq macros instead of `` ''s and ` 's (think typesetting and future
processing); kill redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and numerically order according to section

First complete sweep of man pages, bin/. Command/function names previously
(incorrectly) capatilized are fixed. Comma splices, hyphenations, SYNOPSIS
cleanups, other miscellaneous typos.

more man page fixes; aaron@ug.cs.dal.ca

fix +n description; jkoshy@freebsd

man page error; helbig

minor errors; josh@quick.net

bad Ns

more Ns

oops. ok, why does my footer not show up yet??

roughly 3 hours of slaving results in a much more beautiful mdoc man page.

"the the" purge

update rcsid

branches: 1.1.1;
Initial revision

Minor polishing:
* Delete a stray blank from the command line synopsis
and add the missing .Ar markup to it.
* Do not mention the terminating newline for the empty command
since it isn't mentioned for any other command either.
* Make the description of the empty command easier to understand.
Joint work with martijn@ and jmc@.

document the dropping of the second / and ? in line address REs;
thread started by mazocomp; diff from ropers, shortened by me;

ok martijn schwarze

Make ed's 'l' command end lines with a '$' and make sure that literal
'$' characters are escaped, so that we are POSIX compliant.

The omission of trailing '$' was originally hidden behind a BACKWARDS
flag. This flag was most likely introduced to be compatible with 4.4BSD.
Thanks to naddy@ for pointing me to the 4.4BSD ed implementation.

I tried to trace the origin and enabling of the BACKWARDS flag, since
both FreeBSD and NetBSD have the flag, but only FreeBSD doesn't have it
enabled. Both projects had an alm@ working on ed during 1993-1995 during
which he added this flag to both projects and only enabled it on NetBSD,
but I wasn't able to reach him on any known address.
Thanks to Ed Schouten (ed@freebsd), and Michael W. Lucas of the ed
Mastery book for helping me trying to locate Andrew Moore.

Problem originally prodded by garzon.lucero@gmail.com and later
independently re-requested by n.reusse@hxgn.net.

OK tb@, guenther@, and mwl@mwl.io

nits about trailing punctuation found with mandoc -Tlint

remove the note about the list command (l) displaying a --More--
prompt for huge lines (according to otto this happens only when
BACKWARDS is not defined);

ok otto

honestly i think you should just zap that paragraph - it doesn;t make
sense to document that posix more or less says something should happen,
and that it does.

jmc

make ed restore the user defined prompt (specified with -p) when it was turned
off and then on again with 'P'.

ok daniel@

Avoid .Ns right after .Pf, it's pointless.
In some cases, do additional cleanup in the immediate vicinity.

theo buehler points out that posix specifies a prompt defined using -p
be reinstated when toggled off then on again; this seems to make sense,
but posix is not explicit.

we know that gnu ed and freebsd do reinstate the user defined prompt, but
we do not. no one has yet stepped up to change this, so i'm adding a note
to this effect until such a time as we do/

i have not tweaked the text for -p or "P" to allow for an easy back out
if behaviour does change;

document some more commands that are POSIX extensions. ok jmc@

document in STANDARDS that we do not mark eols with $;
originally reported by ezequiel garz?n

more x removal;

remove nonstandard DES support because DES. ok beck deraadt miod

add an ASYNCHRONOUS EVENTS section for signals, as per vi;
ok millert

STANDARDS:
- `%' is an extension
- `^' is neither required nor prohibited by posix
- the deprecated `-' option is "behaviour unspecified"

ok millert

add an EXIT STATUS section for /bin;

properly escape some "!"; reported by kristaps

move exit returns blurb out of DIAGNOSTICS; from daniel dickman

remove references to docs we no longer install;

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

for the `g' and `G' commands, document that if no lines match
the regular expression then the current line number remains unchanged;

convert to new .Dd format;

- consistent STANDARDS blurb
- note which options are extensions to POSIX

discussed w/ deraadt otto millert

remove the section on regular expressions - instead point people
to re_format.7 (which is where the list of BREs went);

also, rename LIMITATIONS to CAVEATS, as this is a standard mdoc thing,
and shuffle it to the end of the page;

correct path to usd docs;

some typos and macro simplification;

make references to USD docs clearer;

sort options, and adjust -width of options' list;

replace .Em with more appropriate macros. some other cleanup;

escape punctuation;
ok deraadt@

USD docs for ed are 9-10, not 12,13;

- section reorder
- correct macro
- escape some whitespace

typos;

suggestions, corrections and ok millert@

copyrights added;

ed(1): Andrew Moore
patch(1): Larry Wall (thanks espie@ for help with this one)
units(1): Adrian Mariano

wrong word; cjeker@diehard.n-r-g.com

Unbreak. We have situations where last space in the line is required.
From dfa@openbsd.ru

Mention deprecated '-' flag (same as -s) since it is listed in the
SYNOPSIS.

Initial patch for a new mdoc issue.
Powered by @mantoya:
o) kill extra line in the end of file;
o) kill extra space in the end of line;
o) replace blank lines with .Pp;

millert@ ok

o) start new sentence on a new line;
o) don't use .Pp before/after .Ss;
o) wrap long lines;
o) fix bogus .Xr usage;

millert@ ok;

we don't like:
o) .Pp before/after .Sh;
o) .Pp before/after .Rs/.Re;
o) .Nm without argument in SYNOPSIS;

ok, tmac is now fixed

join .%A entries; most by bk@rt.fm

Various fixes; mpech@prosoft.org.lv

- Some section shuffling: conform to the standard order documented in mdoc(7)
- .Sh AUTHOR -> .Sh AUTHORS

Insert some missing commas.

- Get rid of more short lines.
- Fix a formatting error I missed in the last commit.

- Fix numerous formatting glitches.
- Convert plain reference to an mdoc macro'd reference.
- Get rid of some annoying short lines, which make the man src hard to read.
- parenthesis -> parentheses

Some fixups.

Don't hyphenate the words {left|right}most.

Mostly punctuation fixes.

Add HISTORY sections; from FreeBSD. Information originally obtained from
"A Quarter Centry of UNIX, Peter H. Salus, Page 41".

Remove hard sentence breaks.

trash some old leftover macros and replace them with -mdoc macros

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

fix a command sequence description; d@, also some misc cleanup

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

start killing redundant .Nm macro arguments (mandoc ``remembers'' the first one
it's given)

use .Dq/.Sq macros instead of `` ''s and ` 's (think typesetting and future
processing); kill redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and numerically order according to section