Page MenuHomeFreeBSD

tsort(1): Add EXAMPLES section
Needs ReviewPublic

Authored by fernape on Wed, Jul 29, 5:48 PM.

Details

Reviewers
None
Group Reviewers
manpages
Summary

Add some examples for this tool. Be aware that I did not add any examples for
-l since I can not grasp how it really works. For example, imagine a file like
this:

A B
B C
C A
A D
D E
E F
F A

This is what we show without -l:

tsort: cycle in data
tsort: A
tsort: D
tsort: E
tsort: F
F
tsort: cycle in data
tsort: A
tsort: B
tsort: C
C
A
D
B
E

and with -l:

tsort: cycle in data
tsort: A
tsort: D
tsort: E
tsort: F
F
tsort: cycle in data
tsort: A
tsort: B
tsort: C
C
A
D
B
E

So exactly the same output

Compare this with the output of OpenBSD 6.7 for the same file.

Without -l:

tsort: cycle in data
tsort: A
tsort: D
tsort: E
tsort: F
A
B
C
D
E
F

and with -l:

tsort: cycle in data
tsort: D
tsort: E
tsort: F
tsort: A
F
tsort: cycle in data
tsort: B
tsort: C
tsort: A
A
B
C
D
E

I also asked in @hackers but got no answer.

Test Plan
  • mandoc -Tlint clean
  • igor clean (spurious warnings about repeating letters in the examples)
  • aspell happy
  • man ./colrm.1 renders the page properly

Diff Detail

Repository
rS FreeBSD src repository
Lint
Lint OK
Unit
No Unit Test Coverage
Build Status
Buildable 32648
Build 30101: arc lint + arc unit

Event Timeline

fernape created this revision.Wed, Jul 29, 5:48 PM
fernape requested review of this revision.Wed, Jul 29, 5:48 PM
fernape edited the summary of this revision. (Show Details)Wed, Jul 29, 5:49 PM