Page Menu
Home
FreeBSD
Search
Configure Global Search
Log In
Files
F159727434
D50410.id155657.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Flag For Later
Award Token
Size
628 B
Referenced Files
None
Subscribers
None
D50410.id155657.diff
View Options
diff --git a/share/man/man5/style.mdoc.5 b/share/man/man5/style.mdoc.5
--- a/share/man/man5/style.mdoc.5
+++ b/share/man/man5/style.mdoc.5
@@ -34,6 +34,14 @@
This file specifies the preferred style for manual pages in the
.Fx
source tree.
+.Ss Maintainability
+Consider our most stable base tooling when writing manuals.
+Keep semantics together so that they are discoverable with
+.Xr grep 1 .
+Where possible, please wrap
+.Xr roff 7
+lines at 72 characters so that they do not become unfriendly to people
+using line numbering on long-established default console geometries.
.Ss Code Examples
.Bl -dash -width ""
.It
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Thu, Jun 18, 1:59 PM (14 h, 21 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
34052029
Default Alt Text
D50410.id155657.diff (628 B)
Attached To
Mode
D50410: style.mdoc: Ask for maintainable wrapping
Attached
Detach File
Event Timeline
Log In to Comment