Hur man hittar dokumentation i mitt eget GNU / Linux-system

Många av de nya i världen GNU / Linux de är fulla av tvivel och kan inte hitta ett snabbt svar på sina problem, ibland har de inte ens en anslutning för att komma åt ett supportforum och slutligen sluta med tanken att Linux är mycket svårt för dem.

De flesta av dem som befinner sig i den här situationen är inte medvetna om att vårt eget system innehåller en bra del av svaren på våra ursprungliga problem. Det finns i huvudsak tre källor till dokumentation i ett system GNU / Linux: manuella sidor (man-sidor), informationssidor (informationssidor) och manualer för applikationer förpackade i / usr / share / doc.

I den här artikeln kommer vi att beskriva var och en av dessa källor.

---

Man-sidor

Manuella sidor eller "man-sidor" är de klassiska referensdokumentationen i Linux och Unix. Helst kan du söka på man-sidorna efter hjälp för alla kommandon, konfigurationsfiler eller biblioteksrutiner.

I praktiken är Linux gratis programvara, och vissa sidor har inte skrivits eller visat sin ålder. Men man-sidor är det första stället att titta när du behöver hjälp. För att komma åt man-sidorna, skriv bara människa följt av ämnet som ska undersökas.

En personsökning startas, så du kommer att trycka på q när jag är klar att läsa. Till exempel för att hitta information om kommandot ls, Jag skulle skriva:

$ man ls

Att känna till delarna på man-sidorna kan hjälpa dig att snabbt hoppa till den information du behöver. Du hittar följande avsnitt på man-sidan (ruta 1):

Tabell 1: Manuella sidor

NAMN	Kommandonamn och beskrivning
SYNOPSIS	Hur man använder kommandot
BESKRIVNING	Fördjupad förklaring av hur kommandot fungerar
EXEMPEL	Förslag på hur du använder kommandot
SE ÄVEN	Relaterade ämnen (vanligtvis på man-sidor)

Avsnitt av mansidorna

Filerna som innehåller man-sidorna lagras i / usr / dela / man (eller i / usr / man på vissa gamla system). Inom den katalogen kommer du att upptäcka att manuella sidor är organiserade i följande avsnitt (ruta 2).

Tabell 2: Avsnitt på manuella sidor

man1	Användarprogram
man2	Systemanrop
man3	Biblioteksfunktioner
man4	Speciella filer
man5	Filformat
man6	spel
man7	Miscellany

Flera mansidor

Vissa ämnen finns i mer än ett avsnitt. För att demonstrera detta kommer vi att använda kommandot vad är, som visar alla man-sidor tillgängliga för detta ämne:

$ vad är printf

printf (1) - formatera och skriva ut data

printf (3) - formaterad utdataomvandling

I detta fall, man printf det skulle vara på sidan i avsnitt 1 (Användarprogram). Om vi ​​skulle skriva ett C-program skulle vi vara mer intresserade av sidan i avsnitt 3 (Biblioteksfunktioner). Du kan ringa ett visst avsnitt av man-sidor genom att ange det på kommandoraden, så att be om printf, vi kan skriva:

$man 3 printf

Hitta rätt mansida

Ibland är det svårt att hitta några mansidor om ett visst ämne. I så fall kan du använda man -k för att hitta avsnittet NAMN på mansidorna. Vet att detta är en strängsökning, så något liknande man -k ls skulle ge dig många utdata, här är ett exempel med ett mer specifikt ord:

$ man -k whatis whatis (1) - skriver ut manuella sidbeskrivningar

Allt om apropos

Det föregående exemplet gav oss några fler poäng. Först kommandot handla om exakt motsvarar man -k, (Egentligen ger jag dig en hemlighet. När du springer man -k faktiskt springa handla om bakom kulisserna).

---

MANPATH-kodraden

Vi vänder oss nu till den andra typen av dokumentation som vi hittar i vårt GNU / Linux-system. Som standard letar manprogrammet efter man-sidorna i / usr / share / man, / usr / lokal / man, / usr / X11R6 / man och möjligen / opt / man. ibland kan du hitta vad du behöver genom att lägga till en ytterligare sökväg till sökvägen. I så fall är det bara att redigera /etc/man.conf i en textredigerare och lägg till en rad enligt följande:

MANPATH / opt / man

Härifrån någon mansida i katalogen / opt / man kommer att hittas. Kom ihåg att du måste springa igen makewhatis för att lägga till dessa nya man-sidor i databasen vad är.

---

GNU -information

En av bristerna på manuella sidor är att de inte stöder hypertext, så du kan inte enkelt hoppa från en sida till en annan. Vänner till GNU känner igen denna brist, så de uppfann ett annat dokumentationsformat: "info" -sidorna.

Många av GNU-programmen har omfattande dokumentation i informationssidformatet. Du kan börja läsa informationssidor med kommandot info:

På det här sättet tar vi ett index över alla informationssidor som finns tillgängliga i systemet. Du kan flytta i dem med piltangenterna, följa "länkar" (indikeras med en stjärna) med Enter-tangenten och avsluta genom att trycka på q. Nycklarna är baserade på Emacs, så det bör vara lätt att navigera om du känner till den redaktören.

För mer information om användning av info, läs deras infosida. Du bör kunna navigera genom att använda knapparna ovan:

$ info info

---

/ usr / dela / doc

Det finns en sista källa som kan hjälpa dig inom Linux-systemet. Många program är utrustade med ytterligare dokumentation i andra format: text, PDF, PostScript, HTML, för att nämna några.

Ta en titt på / usr / dela / doc (/ usr / doc på gamla system). Du hittar en lång lista med kataloger, som alla kommer med applikationerna på ditt system. Att söka igenom denna dokumentation kan ofta avslöja något intressant, till exempel handledning eller ytterligare teknisk dokumentation. En snabb kontroll avslöjar massor av material som finns att läsa:

$ cd / usr / dela / doc

$ hitta. -typ f | wc -l

---

I andra artiklar kommer vi att hänvisa till externa källor till dokumentation som Linux Documentation Project (LDP), e-postlistor och nyhetsgrupper.

Källa: Artikel hämtad från GUTL och skriven av Maikel Llamaret Heredia. Länkar: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org