mischief/openbsd-src
1
0
Fork 0
mirror of https://github.com/openbsd/src.git synced 2025-01-10 06:47:55 -08:00
Code
231,187 Commits 1 Branch 0 Tags 812 MiB
83d14a1130
Commit Graph

68 Commits

Author SHA1 Message Date
kn
881f6c5ff0 Denote multiple arguments with 'arg ...' not 'args' 
A few programs used the plural in their synopsis which doesn't read as
clear as the obvious triple-dot notation.

mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent
use of 'arg ...' matches that behaviour.

Cleanup a few markups of the same argument so the text keeps reading
naturally;  omit unhelpful parts like 'if optional arguments are given,
they are passed along' for tools like time(1) and timeout(1) that obviously
execute commands with whatever arguments where given -- just like doas(1)
which doesn't mention arguments in its DESCRIPTION in the first place.

For expr(1) the difference between 'expressions' and 'expression ...' is
crucial, as arguments must be passed as individual words.

Feedback millert jmc schwarze deraadt
OK jmc
 2022-12-22 19:53:22 +00:00
naddy
41ce3b17e7 man pages: add missing commas between subordinate and main clauses 
jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@
 2022-03-31 17:27:13 +00:00
naddy
143054fa78 Switch cdio's default CDDB database to gnudb.gnudb.org:8880. 
The freedb.org CD track database has been discontinued.

Retire cddb/888 from /etc/services.  Nothing uses this any longer.
gnudb.org uses the "cddbp-alt" port of 8880, but we don't need a
services(5) entry for a single site.

ok deraadt@
 2020-06-26 19:51:14 +00:00
jmc
627ebc33bf sort SEE ALSO; 2020-04-22 05:37:00 +00:00
deraadt
596a878a59 move mixerctl and audioctl man pages to section 8, as these work 
against root-only device nodes.
 2020-04-21 21:32:26 +00:00
ratchov
791a5c25a2 Remove references to "aucat socket". 
The "aucat socket" was removed ~7 years ago. As the output could be
anything on the network, also drop the .Xr to audio(4).

ok sthen jmc
 2019-10-02 07:43:20 +00:00
jmc
bc20e4327c expand TAO in the correct place; from michael reed 
this commit differs a little from the diff michael posted:

- i've uppercased the expansion, which seems a better fit
- reworked a later description to fit
 2017-03-19 18:40:11 +00:00
bentley
9dbd696514 Reduce usage of predefined strings in manpages. 
Predefined strings are not very portable across troff implementations,
and they make the source much harder to read. Usually the intended
character can be written directly.

No output changes, except for two instances where the incorrect escape
was used in the first place.

tweaks + ok schwarze@
 2015-02-28 21:51:56 +00:00
schwarze
27e959701b obvious cases of missing .An; 
found with the new mandoc(1) MANDOCERR_AN_MISSING warning;
no text changes
 2014-09-08 01:27:54 +00:00
stsp
72005a6214 Document default write speed of tao subcommand. 2011-07-09 18:10:24 +00:00
tedu
eb68ddbbaf no mcd 2011-06-26 23:45:26 +00:00
jmc
e62f24032a more wacky macro fixing; 2010-09-19 21:30:04 +00:00
jmc
f14a1b4ca8 - fix a spacing issue in SYNOPSIS 
- occurence -> occurrence
 2010-07-26 21:14:39 +00:00
krw
dc4cd921ad Add printing of current profile and feature information to 'info' 
command with -v. Make a second -v cause printing of raw feature
data and a full list of profiles. A few minor tweaks to the feature
bitmap handling. Helps in debugging media problems in cdio.

Suggestions from fgsch@, man page fixes from jmc@ as usual.

ok beck@ deraadt@
 2010-03-01 02:09:44 +00:00
jmc
74fdbf9dc8 try to get "play" right; help/ok naddy 2009-06-09 22:20:44 +00:00
naddy
c4c97271b4 Synchronize man page and help output. 
From a least of details by sobrado@; input by jmc@ who still isn't happy.
 2009-06-03 00:45:59 +00:00
ratchov
3bcf870de4 Explain the AUDIODEVICE env. variable similarly to how sio_open(3) does. 
discussed with jmc@
 2009-04-10 18:51:44 +00:00
av
7b34dc5ff0 set speed for writing tracks in TAO. 
ok and tweaks by fgsch
manual page by jmc
 2008-06-30 23:35:39 +00:00
jmc
e8b57fad78 clarify tao's -a option; ok av fgsch 2008-06-24 14:00:01 +00:00
jmc
70d16cb159 new sentence, new line; 2008-06-23 07:04:50 +00:00
av
f7dfecd4ed Automatically distinguish between CD-DA track and WAVE audio file writing them 
in TAO mode. For WAVE files we should skip header.

ok and comments by fgsch
 2008-06-22 21:04:01 +00:00
jmc
dfdb3b6249 make TOC greppable; 2007-11-12 20:37:42 +00:00
sobrado
2e3e646ef2 lexicographically sorts the list of commands 
ok jmc@
 2007-07-22 21:27:55 +00:00
jmc
573c3cbbbe - document the "play" default a little more clearly 
- document the difference between "play" and "cdplay" more clearly

ok mjc
 2007-07-20 09:06:17 +00:00
jmc
9490d37cb6 convert to new .Dd format; 2007-05-31 19:19:00 +00:00
jmc
e3c6f1b3ed fix some list items; from andres 2007-05-29 22:32:36 +00:00
mjc
a076f0c490 cdrip and cdplay commands from Alexey Vatchenko 
incorporating some manpage suggestions from jmc@
 2007-05-26 03:00:03 +00:00
jmc
7714732844 fix wording for `replay'; from AndrAcs 2007-03-26 11:46:07 +00:00
jmc
2150bcaf12 /dev/rcd0d -> /dev/rcd0c; from AndrAcs 2007-03-18 23:56:19 +00:00
jmc
6b6acf025c document environment var CDROM; from ross l richardson (pr #5258) 
i used a different fix, and merged the CDROM stuff into DISC.
whilst in there, document the default if neither is given.

ok mjc
 2006-10-12 20:38:03 +00:00
jmc
eddc3fcb4f - tweak the -f description 
- move DISC into an ENVIRONMENT section
- make the tao option list -compact
- uppercase `cddb'
 2006-06-22 11:25:01 +00:00
jmc
32a69eca38 update .Nd, SYNOPSIS, and DESCRIPTION, after alexey e. suslikov pointed 
out that it was a bit dated;

ok mjc
 2006-06-10 14:05:45 +00:00
jmc
74560c7c57 tidy up the "tao" section; 
diff from deraadt or mjc, i'm not sure; tweaks by me
ok deraadt
 2006-06-01 07:55:10 +00:00
mjc
cf22b6b503 better command line usage as suggested by deraadt@ 
ok @deraadt
 2006-06-01 06:32:17 +00:00
jmc
425dcfe3fa better description for the volume commands; ok mjc 2006-05-31 20:59:32 +00:00
jmc
973ba423c4 tweaks; 2006-05-31 08:30:36 +00:00
mjc
7993cded49 add rewritable blanking and track-at-once burning support 
ok deraadt@
 2006-05-31 01:14:41 +00:00
krw
faf9d55e91 Make man page reflect current reality of play command. jmc@ cleaned 
up version of my original diff.

ok jmc@
 2006-01-23 00:41:10 +00:00
robert
91b4e8dc4b add an exit command as an alias of quit; ok henning@ 2005-01-22 10:21:26 +00:00
jmc
dcaa2edf89 sort the list of available interactive commands to cdio, and clean up their 
descriptions somewhat;
 2004-07-30 12:30:33 +00:00
jmc
3888ebd6b0 - sort options 
- missing full stop
- uppercase `id'
- add SEE ALSO; suggested by Alexey E. Suslikov
- add `-d host:port' to usage()
 2004-07-30 11:59:03 +00:00
jmc
2aeff9fb4d - section reorder 
- COMPATIBILITY merge
- macro cleanup
- kill whitespace at EOL
- new sentence, new line

ssh pages ok markus@
 2003-06-10 09:12:09 +00:00
jmc
de23af841a copyrights added; 
Serge V. Vakulenko

thanks espie@ for help
 2003-02-18 09:42:33 +00:00
fgsch
a681df93ee - Add missing cdid command to cdio.1. 
- Remove ambiguity between cddbinfo and cdid commands, so CD matches
  cddbinfo and CDI cdid.
millert@ ok.
 2002-10-24 20:03:07 +00:00
espie
6b871bb498 document default cdio connection 2002-05-19 12:39:54 +00:00
espie
9ed7639af4 Add cddb support. 2002-04-18 20:18:31 +00:00
mpech
0cfa78c6b0 o) {Open,Net,Free}BSD -> .{O,N,F}x; 
o) "start sentence on new line" issues;
o) minimal -mdoc improvements;

millert@ ok
 2001-08-17 11:13:57 +00:00
aaron
168f5c3f32 Get rid of ugly usage() output. People can read the man page to get a command 
list. Sync the usage() with the man page.
 2000-12-24 11:34:09 +00:00
espie
4b60b21541 Make cdio subject line more explicit (aaron & me) 2000-12-23 20:30:19 +00:00
aaron
f1ba34738e Change all option list specifications to ".Bl -tag -width Ds". Most man 
pages just needed their -width parameter tweaked to "Ds", which provides
a nice width of 6 constant characters. For consistency more than anything.
 2000-11-09 17:51:53 +00:00