News for hackers. Stuff that matters.
Re:Practical Unix Manuals: mdoc by beefhash on Saturday November 25, 2017 @10:00AM (#15776196)
Semantic markup has a use, at least on OpenBSD. You can use the semantic markup for searching manual pages, like this[1]:

> Search for manuals in the library section mentioning both the “optind” and the “optarg” variables:

> $ apropos -s 3 Va=optind -a Va=optarg

[1] https://man.openbsd.org/whatis.1

Re:Practical Unix Manuals: mdoc by nerdponx on Saturday November 25, 2017 @10:40AM (#15776353)
I wish I could use semantic markup to jump to a definition, either of an option or a subcommand.
Re:Practical Unix Manuals: mdoc by yepguy on Saturday November 25, 2017 @03:16PM (#15777753)
You can actually. If you use mandoc instead of mandb, it automatically generates and passes tag files to less. Then you can just type ":t e" to jump to the docs for the -e option, for example.
Re:Practical Unix Manuals: mdoc by nerdponx on Sunday November 26, 2017 @10:37AM (#15781313)
Interesting, so theoretically that is something that every distro could and should be doing?
Re:Practical Unix Manuals: mdoc by humanrebar on Saturday November 25, 2017 @10:09AM (#15776225)
When does someone need to search for that sort of thing?
Re:Practical Unix Manuals: mdoc by beefhash on Saturday November 25, 2017 @10:12AM (#15776238)
A more realistic example might be that you're changing $LANG and now something broke. You can thus search for everything that uses LANG[1] and see what's most likely to have broken in what way.

[1] https://man.openbsd.org/?query=Ev%3DLANG&apropos=1&sec=0&arc...

Re:Practical Unix Manuals: mdoc by jwilk on Saturday November 25, 2017 @11:57AM (#15776697)
There are some many things that are affected by locale environment variables (most of the time without documenting it explicitly), that this particular query is mostly useless.