Bug 236970 - Update intro(4) man page
Summary: Update intro(4) man page
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Guangyuan Yang
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-04-02 17:54 UTC by Andrew "RhodiumToad" Gierth
Modified: 2019-04-11 00:44 UTC (History)
2 users (show)

See Also:


Attachments
rewrite of intro(4) (7.68 KB, patch)
2019-04-02 17:54 UTC, Andrew "RhodiumToad" Gierth
no flags Details | Diff
New patch with style fixes as requested on review (7.70 KB, patch)
2019-04-03 09:29 UTC, Andrew "RhodiumToad" Gierth
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Andrew "RhodiumToad" Gierth 2019-04-02 17:54:06 UTC
Created attachment 203325 [details]
rewrite of intro(4)

Much of intro(4) has been obsolete since 5.0.

Here is a proposed rewrite.
Comment 1 Andrew "RhodiumToad" Gierth 2019-04-02 18:02:17 UTC
Also at

https://reviews.freebsd.org/D19799
Comment 2 Andrew "RhodiumToad" Gierth 2019-04-03 09:29:37 UTC
Created attachment 203339 [details]
New patch with style fixes as requested on review

New patch with markup/style fixes as requested on review
Comment 3 commit-hook freebsd_committer freebsd_triage 2019-04-04 18:53:03 UTC
A commit references this bug:

Author: ygy
Date: Thu Apr  4 18:52:03 UTC 2019
New revision: 345887
URL: https://svnweb.freebsd.org/changeset/base/345887

Log:
  Rewrite intro(4) man page.

  - Remove issues that no longer apply thanks to devfs
  - Add language pointing out devfs's role and referencing its config
  - Add a "historical notes" section and move discussion of block vs character devs to it, including pointing out the removal of block devs
  - Modernize some examples

  MFC after:	1 week
  PR:		236970
  Submitted by:	andrew@tao173.riddles.org.uk
  Reviewed by:	0mp
  Differential Revision:	https://reviews.freebsd.org/D19799

Changes:
  head/share/man/man4/intro.4
Comment 4 commit-hook freebsd_committer freebsd_triage 2019-04-11 00:41:36 UTC
A commit references this bug:

Author: ygy
Date: Thu Apr 11 00:41:07 UTC 2019
New revision: 346111
URL: https://svnweb.freebsd.org/changeset/base/346111

Log:
  MFC r345887:

  Rewrite intro(4) man page.

  - Remove issues that no longer apply thanks to devfs
  - Add language pointing out devfs's role and referencing its config
  - Add a "historical notes" section and move discussion of block vs character devs to it, including pointing out the removal of block devs
  - Modernize some examples

  PR:		236970
  Submitted by:	andrew@tao173.riddles.org.uk
  Reviewed by:	0mp
  Differential Revision:	https://reviews.freebsd.org/D19799

Changes:
_U  stable/12/
  stable/12/share/man/man4/intro.4