<chapter id="help-system-user-manual">
<docinfo>
<date>02/10/2000</date>
<releaseinfo>1.94.00</releaseinfo>
</docinfo>
<title>Manual för KDE:s hjälpsystem</title>
<anchor id="help">

<sect1 id="help-introduction">
<title>KDE:s hjälpsystem</title>

<para>KDE:s hjälpsystem är designat för att enkelt komma åt UNIX:s
standardhjälpsystem (<application>man</application> och
<application>info</application>), lika väl som KDE:s egna dokumentation
(<abbrev>HTML</abbrev>). </para>

<para>Alla KDE:s basprogram är fullständigt dokumenterade tack vare
dokumentationsgruppens arbete. Om du vill hjälpa till så kan du skriva
till Mike McBride (e-post <email>mmcbride@ematic.com</email>), som är
samordnare för dokumenteringen. Du behöver inte ha någon erfarenhet, utan
det räcker med entusiasm och tålamod. Om du skulle vilja hjälpa till med
att översätta KDE:s dokumentation till ditt modersmål så kan du kontakta
&eacute;ric Bischoff <email>ebisch@cybercable.tm.fr</email>, som är
samordnare för översättningarna. Mer information, inklusive samordnarna
för översättningen av de olika språken, kan du hitta på
<ulink url="http://i18n.kde.org">Webbplatsen för internationalisering</ulink>
samt i <link linkend="contact">kontakt</link>-sektionen av det här
dokumentet. </para>

<sect2 id="installation">
<title>Installation</title>

<para>&khelp; är en integrerad del av KDE:s basinstallation, och installeras
med varje kopia av KDE. Du hittar det i paktete kdebase, som du kan hämta
från <ulink url="ftp://ftp.kde.org/">KDE:s FTP-plats</ulink> eller genom
att installera paketet kdebase i din Linux-distribution.</para>

</sect2>
</sect1>

<sect1 id="invoking-help">
<title>Att ta fram hjälpen</title>

<para>&khelp; kan startas på flera sätt:</para>

<variablelist>
<varlistentry>
<term>Från <guimenu>Hjälp</guimenu>-menyn</term>
<listitem><para>Det vanligaste sättet är förmodligen inifrån programmet.
Välj <menuchoice><guimenu>Hjälp</guimenu>
<guimenuitem>Innehåll</guimenuitem></menuchoice> för att öppna ett programs
hjälpfil. Du startar då på innehållssidan.</para></listitem>
</varlistentry>

<varlistentry>
<term>Från <guimenu>K</guimenu> menyn</term>
<listitem><para>Klicka på det stora <guiicon>K</guiicon>:et i panelen och välj
<guimenuitem>Hjälp</guimenuitem> för att öppna &khelp;. Du startar då på välkomstsidan.</para></listitem>
</varlistentry>

<varlistentry>
<term>Från panelen</term>
<listitem><para>Panelen (<application>Kicker</application>) innehåller som standard
en ikon som heter &khelp;. Välkomstsidan kommer att visas igen.</para></listitem>
</varlistentry>

<varlistentry>
<term>Från kommandoraden</term>
<listitem><para>&khelp; kan startas enom att använda en webbadress för
att visa en fil. Webbadresser har även lagts till för
<application>info</application>- och <application>man</application>-sidor.
Du kan använda dem på följande sätt:</para>

<variablelist>
<varlistentry>
<term>Ett programs hjälpfil</term>
<listitem><para><command>khelpcenter
<option>help:/<replaceable>kedit</replaceable></option></command></para>
<para>Öppnar <application>Kedit</application>:s hjälpfil på innehållssidan.
</para></listitem>
</varlistentry>

<varlistentry>
<term>En lokal webbadress</term>
<listitem><para><command>khelpcenter
<option><replaceable>file:/usr/local/src/qt/html/index.html</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>En manualsida</term>
<listitem><para><command>khelpcenter
<option>man:/<replaceable>strcpy</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>En infosida</term>
<listitem><para><command>khelpcenter <option>info:/<replaceable>gcc</replaceable></option></command></para></listitem>
</varlistentry>
</variablelist>

<para>Om <command>khelpcenter</command> körs utan några parametrar så öppnas 
välkomstsidan</para></listitem>
</varlistentry>

</variablelist>
</sect1>

<!-- Interface - Basics, using Konqueror -->
<sect1 id="interface-basics">
<title>Gränssnittet i &khelp;</title>

<para>Gränssnittet i &khelp; består av två avdelningar med information,
inlagda i ett &konq;-fönster. Det här medför att det blir enkelt och
intuitivt att navigera med hjälp av &konq;s egna verktygsrader, precis
som du skulle göra på en webbsida. Dessutom innehåller de flesta dokumenten
sina egna navigeringsverktyg som gör det möjligt att läsa dokumentets delar
i ordning med länkarna <guilabel>Nästa</guilabel> och <guilabel>Föregående
</guilabel>, alternativt att förflytta sig mindre strukturerat med hjälp
av hyperlänkarna. Länkar kan förflytta dig till andra delar av samma dokument
eller till ett annat dokument. Du kan använda ikonerna <guiicon>Bakåt
</guiicon> (en pil åt vänster) eller <guiicon>Framåt</guiicon> (en pil åt
höger) i verktygsraden för att förflytta dig genom de dokument som du
har läst i den aktuella sessionen.</para>

<para>I den vänstra avdelningen visas hjälpsystemets innehåll, och i den högra
visas själva hjälpfilerna.</para>

<sect2 id="contents-pane">
<title>Avdelningen <guilabel>Innehåll</guilabel></title>

<para>Avdelningen <guilabel>Innehåll</guilabel> i &khelp; visas i den
vänstra sidan av fönstret. Som du kanske har gissat så kan du
flytta på avgränsningskanten så att du på ett bekvämt sätt kan läsa
innehållet i de båda avdelningarna.</para>

<para>Avdelningen <guilabel>Innehåll</guilabel> är dessutom uppdelad i
två flikar, en som innehåller en <link linkend="contents-menu">meny</link>
som visar all hjälpinformation som &khelp; känner till, samt en annan
flik som ger dig möjlighet att <link
linkend="search">Söka</link> efter specifik information.</para>

<sect3 id="contents-menu">
<title><guilabel>Innehålls</guilabel>menyn</title>

<para>I <guilabel>Innehåll</guilabel> finns följande poster som standard:
</para>

<variablelist>
<varlistentry>
<term><guilabel>Introduktion</guilabel></term>
<listitem><para>Välkommen till KDE - en introduktion till K skrivbordsmiljö.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Introduktion till KDE</guilabel></term>
<listitem><para>KDE:s snabbstartsvägledning. Innehåller en rundvisning
av KDE:s gränssnitt och specifik hjälp och tips för hur kan arbeta smartare
med KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>KDE:s användarhandbok</guilabel></term>
<listitem><para>KDE:s användarhandbok är en ingående genomgång av
KDE, som tar upp inställning, anpassning och användning.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Programhandböcker</guilabel></term>
<listitem><para>Dokumentation för program som ingår i KDE. Alla KDE-program
har dokumentation i <abbrev>HTML</abbrev>-format. Den här sektionen
innehåller en lista med alla KDE-program med kortfattade beskrivningar
och länkar till den fullständiga dokumentationen.</para>
<para>Programmen visas i en trädstruktur som motsvarar den förinställda
strukturen i <guimenu>K</guimenu>-menyn, vilket gör det enkelt att hitta
programmet som du letar efter.</para></listitem> 
</varlistentry>

<varlistentry>
<term>Systemets manualsidor</term>
<listitem><para>UNIX manualsidor är det traditionella formatet på
dokumentationen för UNIX-system. De flesta program i ditt system har
en manualsida. Dessutom finns det manualsidor för programmeringsfunktioner
och filformat.</para></listitem>
</varlistentry>

<varlistentry>
<term>Systemets info-katalog</term>
<listitem><para>TeXinfo-dokumentation används av många GNU-program, bland
annat <application>gcc</application> (C/C++-kompilatorn),
<application>emacs</application> och många andra.</para></listitem>
</varlistentry>

<varlistentry>
<term>KDE:s frågor och svar</term>
<listitem><para>Vanliga frågor om KDE, och svaren till dem.</para></listitem>
</varlistentry>

<varlistentry>
<term>KDE på webben</term>
<listitem><para>Länkar till KDE på webben, både KDE:s officiella webbplats
och andra användbara platser.</para></listitem>
</varlistentry>

<varlistentry>
<term>Kontaktinformation</term>
<listitem><para>Information om hur du kan kontakta KDE-utvecklare, och
hur du går med i KDE:s e-postlistor.</para></listitem>
</varlistentry>

<varlistentry>
<term>Stöd KDE</term>
<listitem><para>Hur du kan hjälpa till, och hur du gör för att engagera dig.
</para></listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="search">
<title><guilabel>Sök</guilabel>-fliken</title>

<para>För att kunna söka måste du ha programmet <application>ht://Dig
</application> installerat. Information om hur du installerar och
ställer in sökindexet finns tillgänglig i dokumentet. Inställningen av
sökindexet görs i <application>KDE:s Inställningscentral</application>
genom att välja <menuchoice><guisubmenu>Hjälp</guisubmenu>
<guimenuitem>Index</guimenuitem></menuchoice>,
och detaljerad hjälp finns tillgänglig i den modulen.</para>

<para>För ändamålet med det här dokumentet så antar vi att du redan har installerat
och ställt in detta.</para>

<para>Searching the help files is fairly intuitive, enter the word(s) you wish
to search for in the text box, choose your options (if any), and press
<guibutton>Search</guibutton>.  The results display in the viewer pane to the
right.</para>

<para>The options available are:</para>

<variablelist>
<varlistentry>
<term><guilabel>Method</guilabel></term>
<listitem><para>Choose how to search for multiple words.  If you choose
<guilabel>and</guilabel>, results are returned only if all your search terms are
included in the page. <guilabel>or</guilabel> returns results if
<emphasis>any</emphasis> of the search terms are found, and
<guilabel>boolean</guilabel> lets you search using a combination.</para>
<para>Boolean syntax lets you use the operators <literal>AND</literal>,
<literal>OR</literal> and <literal>NOT</literal> to create complex searches.
Some examples:</para>
<variablelist>
<varlistentry>
<term><userinput>cat and dog</userinput></term>
<listitem><para>Searches for pages which have both the words
<userinput>cat</userinput> and <userinput>dog</userinput> in them.  Pages with
only one or the other will not be returned.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>cat not dog</userinput></term>
<listitem><para>Searches for pages with <userinput>cat</userinput> in them, but
only returns the ones that don't have the word <userinput>dog</userinput> in
them.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>cat or (dog not nose)</userinput></term>
<listitem><para>Searches for pages which contain <userinput>cat</userinput>, and
for pages which contain <userinput>dog</userinput> but don't contain
<userinput>nose</userinput>.  Pages which contain both
<userinput>cat</userinput> and <userinput>nose</userinput> would be returned,
pages containing all three words would not.</para></listitem> 
</varlistentry>
</variablelist>
<para>If your searches are not returning the results you expect, check carefully
you haven't excluded the wrong search term with an errand <literal>NOT</literal>
or a stray brace.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Max. results</guilabel></term>
<listitem><para>Determines the maximum number of results returned from your
search.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Format</guilabel></term>
<listitem><para>Decide if you want just a short link to the page containing your
search terms, or do you want a longer summary.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sort</guilabel></term>
<listitem><para>Sort the results in order of <guilabel>Score</guilabel> (how
closely your search terms were matched,) alphabetically by
<guilabel>Title</guilabel> or by <guilabel>Date</guilabel>.  Selecting the
<guilabel>Reverse order</guilabel> check box, naturally enough, reverses the
sort order of the results.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Update index</guilabel></term>
<listitem><para>Update the search index, to incorporate new documents, or if you
think your database is incomplete or damaged.  This may take some
time.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

<sect2 id="man-and-info">
<title>The <application>Man</application> and <application>Info</application>
sections</title>

<para>Man pages are the standard unix manual pages, and have been in use for
many years on many operating systems.  They are extremely thorough, and are the
very best place to get information about most linux commands and
applications.  When people say <quote>RTFM</quote>, the Manual they're referring
to is very often the man page.</para>

<para>The man pages are not perfect however.  They tend to be in depth, but also
extremely technical, often written by developers, and for developers. In some
cases this makes them somewhat unfriendly, if not downright impossible for many
users to understand.  They are however, the best source of solid information on
most commandline applications, and very often the only source.</para>

<para>If you've ever wondered what the number is when people write things like
man(1) it means which section of the manual the item is in.  You'll see &khelp;
uses the numbers to divide the very many man pages into their own sections,
making it easier for you to find the information you're looking for, if you're
just browsing.</para>

<para>Also available are the Info pages, intended to be a replacement for the
man pages.  The maintainer of some applications no longer update the man pages,
so if there is both a man page and an info page available, the info page is
probably the most recent.  Most applications have one or the other though.  If
the application you are looking for help on is a <abbrev>GNU</abbrev> utility,
you will most likely find it has an info page, not a man page.</para>

<sect3 id="navigation">
<title>Navigating inside the <application>Info</application> pages</title>

<para>Info documents are arranged hierarchically with each page called a
node. All info documents have a <guilabel>Top</guilabel> node,
<abbrev>i.e.</abbrev> the opening page.  You can return to the
<guilabel>Top</guilabel> of an info document by pressing
<guilabel>Top</guilabel>.</para>

<para><guibutton>Prev</guibutton> & <guibutton>Next</guibutton> are used to
move to the previous/next page at the current level of the hierarchy.</para>

<para>Clicking on a menu item within a document moves you to a lower level in
the hierarchy. You may move up the hierarchy by pressing
<guibutton>Up</guibutton>.</para>

<para>Man is treated similarly to info, with the section index being the Top
node and each man page on the level below.  Man entries are one page long.</para>

</sect3>
</sect2>
</sect1>

<sect1 id="credits">
<title>Utvecklare och Licenser</title>

<para>&khelp;</para>

<para>Ursprungligen utvecklad av Matthias Elter <email>me@kde.org</email></para>
<para>Nuvarande underhållare är Matthias Hoelzer-Kluepfel
<email>mhk@kde.org</email></para>

&underFDL;
&underGPL;


</sect1>
</chapter>
