Ero sivun ”Dokumentaatio” versioiden välillä
Ei muokkausyhteenvetoa |
LP (keskustelu | muokkaukset) (huomattavaa lisäystä) |
||
| Rivi 1: | Rivi 1: | ||
Useimmista komennoista, keskeisistä tiedostoista, järjestelmäkutsuista yms. on [[Man-sivut|manuaalisivu]], jossa komento ja sen käyttö kuvaillaan, GNU-projektin ohjelmilla on [[info|info-sivut]] ja jokaisesta paketista on yleensä ainakin jotakin tietoa hakemistossa <tt>/usr/share/doc/paketti</tt>, usein jopa kattava ohjekirja. | |||
== Man-sivut == | |||
''Pääartikkeli [[Man]].'' | |||
Man-sivut on Unixin sähköinen (ja haluttaessa paperinenkin) käsikirja (engl. <i>man</i>ual). | |||
Sivuilla kuvaillaan komennot, järjestelmä- ja ohjelmakirjastokutsut, keskeiset asetustiedostot yms. mahdollisimman täsmällisesti, mutta usein käyttäjän oletetaan tuntevan se aihepiiri, johon komento liittyy. Siksi man-sivut voivat aloittelijalle tuntua kryptisiltä. Kun niihin tottuu, ne ovat hyvinkin arvokkaita. | |||
Perinteisen Unixin osalta man-sivut ovat kattavat, mutta monet myöhemmät projektit (GNU, työpöytäympäristöt, graafiset selaimet jne.) ovat kirjoittaneet dokumentaationsa muihin muotoihin ja niitten osalta man-sivut saattavat olla tynkiä tai puuttua kokonaan. | |||
== Info-sivut == | |||
''Pääartikkeli [[Info]].'' | |||
GNU-projektin ohjelmista on usein man-sivun sijasta <tt>info</tt>-sivu, koska man-sivut koettiin liian rajoittuneiksi. Infosivut toimivat [[wikipedia:fi:hyperteksti|hyperteksti]]n tavoin, joten viitteiden käyttö on helpompaa ja esimerkiksi [[emacs]]in info-sivut ovat hyvin kattavat. Monen ohjelman kohdalla info-sivu kuitenkin on keskeneräinen. | |||
== Paketin dokumentaatio == | |||
Hakemistossa /usr/share/doc/paketti on sekalaista tietoa ohjelmapaketista, kuten lisenssi, kääntämisohjeet, muutosloki sekä usein kattavampi ohjekirja, esimerkkejä ohjelman käytöstä, malleja asetustiedostoiksi jne. Hakemiston sisältö ei ole standardoitu kuin joidenkin tiedostojen osalta, mutta ainakin suurempien ohjelmistopakettien kohdalla kannattaa katsoa löytyisikö ohjekirjaa. | |||
Joskus, kun dokumentaatiota on paljon, se on eriytetty omaksi paketikseen (<tt>paketti-doc</tt> tms.), ja ohjekirja löytyy vasta tämän paketin asennuksen jälkeen. Paketin kotisivulta (joka usein kerrotaan esim. README-tiedostossa, muuten hakumoottorit auttavat) saattaa myös löytyä arvokasta tietoa. | |||
Osa hakemistosta löytyvästä tiedosta on tarkoitettu ohjelmaa uudelle alustalle kääntävälle tai sopeuttavalle, mikä saattaa olla hyvinkin hämäävää. Varsinkin <tt>README</tt>-tiedosto kuuluu usein tähän kategoriaan. | |||
== Tietoa verkosta == | |||
Vaikeammissa tapauksissa voit etsiä tietoa mm: | |||
* [http://www.google.com/linux Googlen Linux-hausta] | * [http://www.google.com/linux Googlen Linux-hausta] | ||
* [http://www.tldp.org The Linux Documentation Projectin sivuilta] | * [http://www.tldp.org The Linux Documentation Projectin sivuilta]; jotkut ohjeista ovat kuitenkin pahasti vanhentuneita | ||
* [http://www.icon.co.za/~psheer/book/index.html.gz RUTE] | * [http://www.icon.co.za/~psheer/book/index.html.gz RUTE] | ||
* [http://sal-faq.sourceforge.net SAL-faq] | * [http://sal-faq.sourceforge.net SAL-faq] | ||
* Usenet, josta myös [http://groups.google.com Google osaa hakea] | * Usenet eli nyyssit, josta myös [http://groups.google.com Google osaa hakea]; mm.sfnet.atk.linux, s.a.l.asennus & co ovat hyvin aktiivisia ja avuliaita | ||
Myös kaupallista tukea on saatavilla [[Apua tarjoavat yritykset|monesta paikasta]]. Pyri olemaan looginen, testaa, kokeile ja ihmettele. Tieto tulee monesti kokemuksen kautta. Google "virheilmoitus" voi monesti ratkaista asian nopeasti. | |||
[[Luokka:Ohjeet]] | [[Luokka:Ohjeet]] | ||
Versio 25. lokakuuta 2007 kello 00.34
Useimmista komennoista, keskeisistä tiedostoista, järjestelmäkutsuista yms. on manuaalisivu, jossa komento ja sen käyttö kuvaillaan, GNU-projektin ohjelmilla on info-sivut ja jokaisesta paketista on yleensä ainakin jotakin tietoa hakemistossa /usr/share/doc/paketti, usein jopa kattava ohjekirja.
Man-sivut
Pääartikkeli Man.
Man-sivut on Unixin sähköinen (ja haluttaessa paperinenkin) käsikirja (engl. manual). Sivuilla kuvaillaan komennot, järjestelmä- ja ohjelmakirjastokutsut, keskeiset asetustiedostot yms. mahdollisimman täsmällisesti, mutta usein käyttäjän oletetaan tuntevan se aihepiiri, johon komento liittyy. Siksi man-sivut voivat aloittelijalle tuntua kryptisiltä. Kun niihin tottuu, ne ovat hyvinkin arvokkaita.
Perinteisen Unixin osalta man-sivut ovat kattavat, mutta monet myöhemmät projektit (GNU, työpöytäympäristöt, graafiset selaimet jne.) ovat kirjoittaneet dokumentaationsa muihin muotoihin ja niitten osalta man-sivut saattavat olla tynkiä tai puuttua kokonaan.
Info-sivut
Pääartikkeli Info.
GNU-projektin ohjelmista on usein man-sivun sijasta info-sivu, koska man-sivut koettiin liian rajoittuneiksi. Infosivut toimivat hypertekstin tavoin, joten viitteiden käyttö on helpompaa ja esimerkiksi emacsin info-sivut ovat hyvin kattavat. Monen ohjelman kohdalla info-sivu kuitenkin on keskeneräinen.
Paketin dokumentaatio
Hakemistossa /usr/share/doc/paketti on sekalaista tietoa ohjelmapaketista, kuten lisenssi, kääntämisohjeet, muutosloki sekä usein kattavampi ohjekirja, esimerkkejä ohjelman käytöstä, malleja asetustiedostoiksi jne. Hakemiston sisältö ei ole standardoitu kuin joidenkin tiedostojen osalta, mutta ainakin suurempien ohjelmistopakettien kohdalla kannattaa katsoa löytyisikö ohjekirjaa.
Joskus, kun dokumentaatiota on paljon, se on eriytetty omaksi paketikseen (paketti-doc tms.), ja ohjekirja löytyy vasta tämän paketin asennuksen jälkeen. Paketin kotisivulta (joka usein kerrotaan esim. README-tiedostossa, muuten hakumoottorit auttavat) saattaa myös löytyä arvokasta tietoa.
Osa hakemistosta löytyvästä tiedosta on tarkoitettu ohjelmaa uudelle alustalle kääntävälle tai sopeuttavalle, mikä saattaa olla hyvinkin hämäävää. Varsinkin README-tiedosto kuuluu usein tähän kategoriaan.
Tietoa verkosta
Vaikeammissa tapauksissa voit etsiä tietoa mm:
- Googlen Linux-hausta
- The Linux Documentation Projectin sivuilta; jotkut ohjeista ovat kuitenkin pahasti vanhentuneita
- RUTE
- SAL-faq
- Usenet eli nyyssit, josta myös Google osaa hakea; mm.sfnet.atk.linux, s.a.l.asennus & co ovat hyvin aktiivisia ja avuliaita
Myös kaupallista tukea on saatavilla monesta paikasta. Pyri olemaan looginen, testaa, kokeile ja ihmettele. Tieto tulee monesti kokemuksen kautta. Google "virheilmoitus" voi monesti ratkaista asian nopeasti.