On this day in 1971 the first version of the Unix Programmer's Manual was published.
Uncategorized
3
Posts
1
Posters
0
Views
-
On this day in 1971 the first version of the Unix Programmer's Manual was published. This included the first ever man pages.
-
On this day in 1971 the first version of the Unix Programmer's Manual was published. This included the first ever man pages.
I like a good man page. As reference documentation for command line programs and such, they can be really good. "What does foo do? I'll run 'man foo' to see. Oh! That's useful!" should take at most seconds.
Most man pages aren't good. They're long, don't follow conventional structure, are badly formatted, lack examples, are written for the author and not the reader. Every time I open a man page that starts with a BNF syntax specification for the command's CLI I despair.
-
I like a good man page. As reference documentation for command line programs and such, they can be really good. "What does foo do? I'll run 'man foo' to see. Oh! That's useful!" should take at most seconds.
Most man pages aren't good. They're long, don't follow conventional structure, are badly formatted, lack examples, are written for the author and not the reader. Every time I open a man page that starts with a BNF syntax specification for the command's CLI I despair.
Writing a good man page is mostly about producing clear technical writing and following conventions. Conventions are important: they enable readers used to manual pages to look up things very quickly. Convention covers both structure (NAME, SYNOPSIS, DESCRIPTION, EXAMPLE, etc) and formatting.
See the man-pages page in section 7, at least on Debian-style distributions.
The incidental details of markup languages, tooling, etc, are often annoying, and frustrating, but not hard as such.
-
undefined Oblomov shared this topic on
undefined Maronno Winchester :antifa: shared this topic
Gli ultimi otto messaggi ricevuti dalla Federazione
-
@aeva A few artists I like in particular:
- Pendulum (probably the most famous DnB band, bordering on Alternative / Metal)
- Camo & Krooked, Mefjus (a bit "artsy" and experimental)
- Venjent (this guy can turn any random sample into a real banger)
- Koven, Fox Stevenson (actual lyrics there)
- Chase & Status, Sigma, Rudimental (for the true UK sound ;)
- various others: Feint, Friction, Maduk, MurdockFor a specific track recommendation, that's gotta be https://www.youtube.com/watch?v=1oSxF0cNlNM - a true hymn!
-
@nclm again great points Nicolas, I really appreciate you sharing these ideas...
-
Neil Young + Promise Of The Real - The Monsanto Years (2015)
Preceduto da feroci critiche ma anche da recensioni positive, il nuovo album di Neil Young non è certo un disco da buttare. L’inglese Mojo, che dà quattro stelle a cani e porci, gli affibbia uno striminzito due e mezzo, altri addirittura due stelle. Onestamente, dopo averlo ascoltato abbastan... https://noblogo.org/available/neil-young-promise-of-the-real-the-monsanto-years-2015
Segui il blog e ascolta un album al giorno: @available
#LaMusicaCiSalva #UnoRadio #NowPlaying #UnoDisco #Spettacoli
-
@aeva :3
-
My plans this week: https://aseachange.com/@elena/statuses/01K971SHJZ9VVRT7WQ0P7QHKQ5 🤗
Starting now with the #YunoHost → #RaspberryPi5 plan, wish me luck!
-
@_elena Really they could either:
– Go the proper way, make a call for offers, receive portfolios/quotes and choose one designer to collaborate with.
– Go the open source way if they prefer, have people offering logos/mascots, all online, with public votes, etc.
But the midway, asking for people to do the entire work and send it to them privately for them to choose, it’s making people work for free, not an open source contribution. They wouldn’t do that for pull requests or other dev tasks?
-
@nclm that's a very good point Nicolas, thank you. I will pass along this note to the Varnish people
-
#Pokrovsk #Ucraina
Una #analisimilitare molto precisa e attendibile pubblicata da Repubblica ieri.
