OS X Terminal ‘man’ pagina’s bekijken in voorvertoning
Onder OS X terminal kun je door middel van het man commando de hulppagina's van een bepaald Terminal commando bekijken. Het nadeel van het man commando is dat de hulppagina's niet handig zijn te lezen en dat je er doorheen moet scrollen in het Terminal venster.
Er bestaat ook een mogeljkheid om de man hulppagina's onder Terminal te 'redirecten' naar de standaard voorvertoning/preview applicatie van OS X. Dit geeft als resultaat dat er een perfect opgemaakt en goed leesbaar document in PDF formaat van wordt gemaakt. De gegenereerde PDF kan handig zijn als naslagwerk wanneer je bijvoorbeeld meerdere opties en parameters van een commando wilt gebruiken.
Om een man pagina te redirecten naar de voorvertoning/preview applicatie typ je:
man -t [commando] | open -f -a /Applications/Preview.app
Vervang [commando] door het commando waarvan je de man hulppagina wilt creëren in voorvertoning/preview bijvoorbeeld: ls, cd, ipconfig, pwd, chmod, etc, etc...
Voorvertoning leest en scrollt net wat lekkerder dan de terminal. Maar zo’n lang commando steeds in tikken en of onthouden is natuurlijkminder handig. Tijd voor een kort shell script.
Maak in /usr/local/bin een bestand aan met bijvoorbeeld de naam: manp (man preview)
Plaats hierin de onderstaande twee regels:
#!/bin/sh man -t $1 | open -f -a /Applications/Preview.app
Zorg dat het bestand uitvoerrechten heeft
chmod u+x manp
Je kunt nu op de command line het volgende commando geven om het een man page in voorvertoning te bekijken
manp [commando]
Karel, bedankt voor de update
| Auteur | Richard IJzermans | |
| Datum | 26/09/2011 09:30 | |
| Categorie | macOS | |
Reacties
Terminal heeft nog wat andere handige functies:
In terminal type bv de letter a, vervolgens druk 2 k eer op de toets, het terminal programma scrolt door alle commando’s die met a beginnen en beschikbaar zijn in terminal.
Type een commando in terminal bv: top
Cursor op commando => R muisknop indrukken en een menu item verschijnt om de man pagina van het betreffende commando te laten.
Selecteer het item een geformatteerde man pagina van dat commando wordt getoond.
Dit is heel handig. Om een PDF-versie van een manpage te krijgen, wist ik tot nu toe niks beters te verzinnen dan te googlen. Hoewel: je hebt (had?) ook bwana, een browser-plugin.
Overigens wordt de notatie ‘[commando]’ hier gebruikt om aan te geven dat je zelf een commandonaam moet invullen. De conventie, met name op de manpages, is dat vierkante haken aangeven dat het veld optioneel is, wat hier duidelijk niet het geval is.
Getest in 10.7.1
Werkt prima als beschreven.
Goeie tip!
Heb dit scriptje geprobeert in Lion. Preview wordt gestart maar er wordt niets weergegeven.