Menu

26 september 2011

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




Gerelateerde tips:




Reacties


  • Jan Smit 26 september 2011 om 9:57

    Heb dit scriptje geprobeert in Lion. Preview wordt gestart maar er wordt niets weergegeven.

  • trikke 26 september 2011 om 10:37

    Getest in 10.7.1
    Werkt prima als beschreven.
    Goeie tip!

  • Eric 26 september 2011 om 12:44

    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.

  • obi 26 september 2011 om 15:10

    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.

Een reactie toevoegen: