Re: Debian pikaohje, versio 2 ja nyt hienona tekstitiedostona

On Fri, 3 Sep 2004, Tapio Lehtonen wrote:
> 1. Ohjeita löytyy
>
>    man sivu tai man bash
>           Lue ruudulta ohjeet kaikista komennoista ja useista
>           asetustiedostoista.

Ehkä "man komento". "Näyttää kuvaruudulle ohjeet komennoista ja..."

Näissä ohjeissa on nyt käytetty aika turhankin vaihtelevia lausemuotoja. Yllä
on imperatiivi "lue", joissain on selitetty mikä ohjelma on ("Lyhyt ohje..."),
joissain kerrotaan mitä ohjelma tekee ("asentaa paketteja tarvittaessa"), jne.
Nämä voisi kaikki yhtenäistää. Korjailin alla kohtia siihen muotoon, mitä
komento tai ohjelma tekee, mutta muutakin voinee käyttää.

Useimmat lauseet eivät muutenkaan ole kunnollisia suomen kielen lauseita.

>    komento [--help, -h]
>           Lyhyt ohje, toimii useimmille komennoille.

Esim. tässä "Näyttää lyhyen ohjeen. Toimii useimmille komennoille.".

>    /usr/share/doc/[paketin-nimi/]
>           Paketin kaikki ohjeet. Tiedosto README.Debian kertoo
>           Debiankohtaiset asiat.

"Sisältää paketin kaikki ohjeet. ..." Tuo ei sikäli pitäne paikkaansa, että
mm. man-sivut eivät taida olla tuolla...

Debian-kohtaiset.

>    Web documentation
>           Hakuteokset, käsikirjat, UKK:t, HOWTOt, jne.:
>           http://www.debian.org/doc/

Miksi "web..." on suomentamatta?

>    Postituslistat ovat http://lists.debian.org/
>           Yhteisö on aina avulias, etsi käyttäjien listoja
>           hakusanalla users.

->   Postituslistat löytyvät osoitteesta http://lists.debian.org/

Ei pilkkua vaan piste.

>    Asennin
>           Kaiken kertoo
>           http://www.debian.org/devel/debian-installer/

->          Asentimen täydelliset ohjeet löytyvät sivulta...

>    boot: expert
>           Asiantunteva käyttäjä pyytää asenninta oletusarvojen
>           käyttämisen sijasta kysymään.

->          Käynnistää asennuksen asiantuntijatilassa, joka
            kysyy parametrit oletusarvojen käyttämisen sijaan.

>    boot: linux26 tai boot: expert26
>           Asennuksessa käytetään Linux-ydintä 2.6.

->          Määrää käyttämään asennuksessa Linux-ydintä 2.6.

>      _________________________________________________________
>
> 3. Viat
>
>    Vianseuranta http://bugs.debian.org/
>           Tiedot uusista ja korjatuista vioista.
>
>    Pakettikohtainen
>           Katso http://bugs.debian.org/paketin-nimi /.

Pakettikohtainen mikä?

-> "Pakettikohtaiset ohjelmaviat"

>    Vianseurantajärjestelmän lumepaketit
>           Katso http://www.debian.org/Bugs/pseudo-packages

"Lumepaketit"? Ei tuollaista omaa sanaa kannata käyttää. Näennäispaketit on
ymmärrettävä.

>    reportbug
>           Ilmoita vioista sähköpostilla.

->          Komento, jolla voi ilmoittaa vioista sähköpostilla.

>    Vikailmoitukset
>           Ohjeet http://www.debian.org/Bugs/Reporting

->   Vikailmoitusten ohjeet
            Löytyvät sivulta ...

>    nano tiedostot
>           Tekstinmuokkain. Jos ei löydy, kokeile emacs, vi, joe.

Tai tekstieditori.

-> "jne."

>    CUPS osoitteessa http://konenimi:631
>           Tulostusjärjestelmän selainkäyttöliittymä.
>
>    dpkg-reconfigure paketin-nimi
>           Tee paketin asetukset uudestaan, esim. console-common
>           (näppäimistö), locales (maa-asetukset).

->          Tekee...

>    update-alternatives valitsimet
>           Määritä oletussovelluksia.

->          Määrittää...

>    update-grub
>           Uuden ytimen asennuksen jälkeen.

->          Annettava uuden...

>    make-kpkg --initrd --revision=2:xx.1.0 --rootcmd fakeroot --uc
>           --us kernel_image
>           Käännä ytimen asennuspaketti lähdekoodeista, jos
>           räätälöityä ydintä tarvitaan. Vaatii kernel-package,
>           fakeroot.

->          Kääntää...
            Vaatii kernel-package- ja fakeroot-paketit

>
> 5. Taustaprosessit ja järjestelmä
>
>    /etc/init.d/tiedosto restart
>           Käynnistä palvelu uudelleen.

->          Käynnistää palvelun...

(jne)

>    /etc/init.d/tiedosto stop
>           Sammuta palvelu.
>
>    /etc/init.d/tiedosto start
>           Käynnistä palvelu.
>
>    halt, reboot, poweroff
>           Pysäyttää, käynnistää uudelleen, sammuttaa sähköt.
>
>    /var/log/
>           Kaikki lokitiedostot ovat tässä hakemistopuussa.

->          Hakemistopuu, joka sisältää kaikki lokitiedostot.

>    /etc/default/
>           Järjestelmän taustaprosessien ja palveluiden
>           oletusasetuksia.

->          Hakemisto, joka sisältää...

>    ps [valitsimia]
>           Näytä käynnissä olevat prosessit.
>
>    su [-] [käyttäjätunnus]
>           Vaihda toiseksi käyttäjäksi, esim. root.
>
>    sudo komento
>           Tavallinen käyttäjä voi suorittaa komennon root:n
>           oikeuksilla, /etc/sudoers

->          "Suorittaa tavallisen käyttäjän antaman komennon
             rootin oikeuksilla. Huomaa asettaa /etc/sudoers.

Ehkä mieluummin "rootin".

>    komento > tiedosto
>           Kirjoita tiedoston päälle komennon tuloste.

->          Kirjoittaa komennon tulosteen tiedostoon.

>    komento >> tiedosto
>           Lisää tiedoston perään komennon tuloste.

->          Lisää komennon tulosteen tiedoston loppuun.

> 7. APT
>
>    apt-get update
>           Päivitä pakettivarastojen (lueteltu tiedostossa
>           /etc/apt/sources.list) hakemistolistaukset. Aja komento
>           jos pakettivarastot ovat muuttuneet tai jos olet
>           epävarma.
>
>    apt-cache search merkkijonot
>           Etsi pakettien nimistä ja kuvauksista merkkijonot.

            Etsii annettuja merkkijonoja pakettien nimistä ja kuvauksista.

>    apt-cache depends pakettien-nimiä
>           Kaikki pakettien tarvitsemat paketit.

->          Asentaa/asenna kaikki....

>    apt-cache rdepends pakettien-nimiä
>           Kaikki paketit jotka vaativat annettuja paketteja.

->          Asentaa/asenna kaikki

>    auto-apt
>           Asentaa paketteja tarvittaessa, korvaa paketin
>           apt-file, vaatii auto-apt.

...(piste) Vaatii auto-apt-ohjelman.

>    aptitude
>           Komentoikkunan käyttöliittymä APT:lle, vaatii aptitude.

->          Visuaalinen käyttöliittymä APTille. Vaatii aptitude-paketin.

> 8. Dpkg
>
>    dpkg -l [pakettien-nimiä]
>           Pakettien tila ja lyhyt kuvaus.

->          Näyttää pakettien tilan ja lyhyen kuvauksen.

>    dpkg -I paketti.deb
>           Tietoa pakettitiedostosta.

->          Näyttää...

>    dpkg -c paketti.deb
>           Pakettitiedoston sisällysluettelo.

->          Näyttää...

>    dpkg -S tiedosto
>           Näytä mihin pakettiin tiedosto kuuluu.
>
->          Näyttää...

>    dpkg -i paketti.deb
>           Asenna pakettitiedosto.

->          Asentaa...

>    dpkg-query -W --showformat=format
>           Tietoja asennetuista paketeista, format on esim.
>           '${Package} ${Version} ${Installed-Size}\n'.

->          Näyttää...

>    dpkg --get-selections > tiedosto
>           Asennettavaksi valittujen pakettien luettelo
>           tiedostoon.

->          Tulostaa ....

>    dpkg - -set-selections < tiedosto
>           Hae asennettavaksi valittujen pakettien luettelo
>           tiedostosta.

->          Lukee asennettavien pakettien luettelon tiedostosta.

> 9. Verkko
>
>    /sbin/ifconfig
>           Tee verkkoasetukset.

->          Ohjelma verkkoasetusten manuaalista asettamista varten.

>    /etc/network/
>           Tiedostot joissa verkkoasetukset, tärkeimmät ovat
>           interfaces ja options.

->          Hakemisto, joka sisältää verkkoasetusten tiedostoja. ...


...jne. En nyt noita kaikkia kommentoinut, mutta kannattaa tosiaan yhtenäistää
noita lausemuotoja jotenkin.

-- Marko Grönroos, [email protected] (http://www.iki.fi/magi/)