summaryrefslogtreecommitdiff
path: root/share/man/man7
AgeCommit message (Collapse)Author
2020-10-14add missing mention of Werner Lemberg,Ingo Schwarze
noticed by Werner himself on <groff at gnu dot org>; while here, add missing .An macros
2020-08-27Fix a bunch of typos in various man pages.Frederic Cambus
2020-07-30some more information about invalid codepoints, bytes, and byte pairs;Ingo Schwarze
OK stsp@
2020-06-30Document the "powerpc64" argument to .Dt.Ingo Schwarze
I intended to commit this after the arch is enabled, but jmc@ requests it right now.
2020-06-25Briefly mention groff_mdoc(7) below SEE ALSO. While both authoritativeIngo Schwarze
manual pages document the same content, comparing can occasionally help in cases of doubt, and some people may prefer one style, some the other. While here, modernize a few .Lks from http:// to https://. OK jmc@
2020-04-28document FETCH_PACKAGES betterMarc Espie
feedback and okay schwarze@
2020-04-23 ce examples of "Ar arg Ar arg" with "Ar arg arg" and stop the spread;Jason McIntyre
2020-03-26Add support for "alpha" suffixes in package versionsJeremie Courreges-Anglas
We already supported "beta" releases but not "alpha", probably to discourage people from pushing "alpha-quality" software in the ports tree. We have 30 ports with distfiles matching "alpha", and people just work around the lack of explicit support for "alpha" releases with mixes of crafted PKGNAME and REVISION/EPOCH. This looks needlessly complicated and a bit unfair when compared to GH_COMMIT support. Pointers from landry@ and sthen@, lgtm landry@, no objection from espie@
2020-03-26Clarify the use of EPOCH in ports Makefiles.paco
Whith lots of help from sthen@, espie@ and jca@ ok espie@ jca@
2020-02-18Mention that .AT, .P, .SB, and .UC are extensions; it really mattersIngo Schwarze
because we only retain the language for backward compatibility in the first place. Part of the research done by <G dot Branden dot Robinson at gmail dot com>, see the list <groff at gnu dot org> for details. No change to the following conventions: Consider portable whatever made it into GNU troff no later than 4.4BSD. For portable extensions, mention their origin at the end of the description. For non-portable extensions, for example from man-ext, usually warn earlier, near the beginning of the description.
2020-02-13Mention that the .Dd "date" argument is the date of the last change.Ingo Schwarze
Triggered by a question from Jason A. Donenfeld. While here, delete three COMPATIBILITY entries that i fixed some time ago.
2020-02-13Digit-width and narrow spaces are non-breaking.Ingo Schwarze
Noticed because Branden Robinson worked on related documentation in groff.
2020-02-09environ(5) was in v7Jonathan Gray
ok schwarze@
2020-02-06mention cbor fido llvm and llvm-c top level include directoriesJonathan Gray
2020-01-23/usr/local/sbin was added in at least 2014 to login.conf's 'path' entry in theOkan Demirmen
'default' class; also added to _PATH_DEFPATH in 2019. Update PATH accordingly. OK millert@
2020-01-19Introduce a new mdoc(7) macro .Tg ("tag") to explicitly mark a placeIngo Schwarze
as defining a term. Please only use it when automatic tagging does not work. Manual page authors will not be required to add the new macro; using it remains optional. HTML output is still rudimentary in this version and will be polished later. Thanks to kn@ for reminding me that i have been considering since BSDCan 2014 whether something like this might be useful. Given that possibilities of making automatic tagging better are running out and there are still several situations where automatic tagging cannot do the job, i think the time is now ripe. Feedback and no objection from millert@; OK espie@ inoguchi@ kn@.
2020-01-16Usually, -width Fl (which is 10n) is too wide and hence ugly.Ingo Schwarze
Change several instances, most of them to the usual -width Ds.
2020-01-10Document the "delim" syntax and its usage.Ingo Schwarze
Closing a gap reported by bentley@, who also sent a patch, but i'm explaining it somewhat differently. While here, remove duplicate information from the text. OK bentley@
2019-12-04document special names that exist in the package systemMarc Espie
2019-09-21add STANDARDS section;Ingo Schwarze
similar to a diff sent in by <Masanori dot Ogino at gmail dot com>, but using the up-to-date reference rather than one from 30 years ago; OK jmc@
2019-08-21sysctl(2): add kern.utc_offset: successor to the DST/TIMEZONE options(4)cheloha
The DST and TIMEZONE options(4) are incompatible with KARL, so we need some other way to compensate for an RTC running with a known offset. Enter kern.utc_offset, an offset in minutes East of UTC. TIMEZONE has always been minutes West, but this is inconsistent with how everyone else talks about timezones, hence the flip. TIMEZONE has the advantage of being compiled into the binary. Our new sysctl(2) has no such luck, so it needs to be set as early as possible in boot, from sysctl.conf(5), so we can correct the kernel clock from the RTC's local time to UTC before daemons like ntpd(8) and cron(8) start. To encourage this, kern.utc_offset is made immutable after the securelevel(7) is raised to 1. Prompted by yasuoka@. Discussed with deraadt@, kettenis@, yasuoka@. Additional testing by yasuoka@. ok deraadt@, yasuoka@
2019-08-11No specific called "exec(3)", so move primary manpage to a name whichTheo de Raadt
does exist -- execv(3). Still call this a family but without "Nm". Adjust Xr in various pages to refer to the precise function used rather than the family, in most cases the semantics of execve(2) are being referenced, so change the Xr. ok jmc
2019-08-10remove groff leftover. from micah muerTheo Buehler
2019-07-15explain escaping of end-of-sentence characters;Ingo Schwarze
missing info reported by Ian <ropers at gmail dot com> on misc@
2019-07-09The non-standard .EX/.EE macro pair was invented for Version 9 AT&T UNIXIngo Schwarze
and only got adopted by GNU two decades later. Thanks to Doug McIlroy <doug at cs dot dartmouth dot edu> for pointing out the error.
2019-07-01use the standard spelling of the word "idiosyncrasy";Ingo Schwarze
suggested by Michal Nowak <mnowak at startmail dot com>
2019-06-21Don't try to fake a horizontal rule with a bunch of hyphens.Anthony J. Bentley
ok jmc@ schwarze@
2019-06-16finish killing PLIST_DB as noticed by some anonymous guyMarc Espie
2019-05-30php5 -> php, php5 has left the ports tree.Jeremie Courreges-Anglas
from Jesper Wallin
2019-05-12Delete documentation of the former HOSTALIASES featuresIngo Schwarze
which was removed in libc/asr/asr.c rev. 1.50 in 2015. Smaller version of a patch posted by Hiltjo Posthuma <hiltjo at codemadness dot org>. No objection was raised when shown on tech@.
2019-05-11socppc makes an extended visit to the bigbucket.Theo de Raadt
ok kettenis
2019-04-26sysupgrade(8) uses /home/_sysupgradeFlorian Obser
suggested by deraadt; OK jmc
2019-04-24clarify the difference between .Cm and .Ic;Ingo Schwarze
triggered by a question from Fabio Scotoni
2019-04-23clarify how .%P is conventionally used;Ingo Schwarze
triggered by a question from Fabio Scotoni <fabio at esse dot ch>
2019-04-23add some missing "pp." to .%P macros;Ingo Schwarze
Fabio Scotoni <fabio at esse dot ch> reported it was missing in eqn(7)
2019-04-21Implement the roff .break request (break out of a .while loop).Ingo Schwarze
Jan Stary <hans at stare dot cz> found it in an ancient groffer(1) manual page (version 1.19) on MacOS X Mojave. Having .break not implemented wasn't a particularly bright idea because obviously, it tended to cause infinite loops.
2019-03-31While we do encourage simplicity in the sense of writing plain '-'Ingo Schwarze
for hyphen-minus, soften the language a bit: writing \- for it is not wrong, and people started sending us patches to replace \- with '-' in existing manual pages, which is not a worthwhile change unless the \- is used at a place where it doesn't belong. OK jmc@
2019-03-10fix some cases of spaces before full stops, where none were neccessary;Jason McIntyre
2019-03-02Do not open a subsection for each and every macro.Ingo Schwarze
Instead, use a tagged list and the canonical .Ic macro as it is natural for such purposes. While here, also delete heaps of needless escaping.
2019-02-11remove a few words to improve flow. ok schwarzeTed Unangst
2019-02-09add a BUGS section explaining the situation with box and line drawingIngo Schwarze
in UTF-8 output; suggested by bentley@
2019-02-08Fix typo: "a data cells" -> "a data cell".Anthony J. Bentley
ok schwarze@
2019-02-07.PpJason McIntyre
.Bd ... -compact is better written as .Bd ...
2019-02-06Remove the misleading statement ".No takes no arguments".Ingo Schwarze
In facts, i works very similarly to .Em and .Sy. Triggered by a question from Kurt Mosiejczuk <kurt at cranky dot work>.
2019-01-25I am retiring my old email address; replace it with my OpenBSD one.Todd C. Miller
2019-01-01Now that .nf and .fi are implemented in the roff(7) parser and formattersIngo Schwarze
rather than in the man(7) parser and formatters, document them in the roff(7) manual, where they belong, rather than in the man(7) manual. Mention that they imply an output line break, and mention which macros imply these requests.
2018-12-23Finally, stop abusing .Ss and .Sx to mark up macros, use .Ic insteadIngo Schwarze
since these are clearly commands in a domain-specific language. As a nice side effect, the resulting list allows including the synopsis for each macro in the item head, reducing some repetitive verbiage.
2018-12-23Simplify and clarify instructions for .Ql, and deprecate .Li.Ingo Schwarze
The macros .Ql, .Dl, and .Bd -literal leave no room for any valid use case for .Li whatsoever. General direction discussed with jmc@.
2018-12-23Deprecate .Lp, use .Pp instead.Ingo Schwarze
Simplicity matters, and fewer macros is simpler. OK jmc@
2018-12-16The .HP macro was deprecated by groff, and that makes senseIngo Schwarze
because it serves no real purpose and works poorly with HTML. While here, describe the section argument of .TH, clarify the syntax display of .TP, and polish some wordings.
generated by cgit v1.2.3 (git 2.25.1) at 2024-12-20 04:51:56 +0000