<!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [

<!ENTITY genindex.sgm SYSTEM "genindex.sgm">
]>
<!-- ?stylesheet href="/local/sgml/style/dsssl/ldp.dsl" type="text/dsssl" -->

<book>
<bookinfo>
  <title>Användarhandledning för LysKOMs emacslispklient</title>
  <date>2002-08-13</date>
  <edition>0.47</edition>

  <copyright>
    <year>1991</year>
    <year>2002</year>
    <holder>
      <ulink url="http://www.lysator.liu.se/">
        <citetitle>Lysator</citetitle>
      </ulink>
    </holder>
  </copyright>

  <publisher>
    <publishername>Lysator</publishername>
    <address>
      <street>c/o ISY, Linköping University</street>
      <postcode>SE-581 83</postcode>
      <city>Linköping</city>
      <country>Sweden</country>
      <email>lyskom@lysator.liu.se</email>
      <otheraddr>
        <ulink url="http://www.lysator.liu.se/">
          <citetitle>Lysator</citetitle>
        </ulink>
      </otheraddr>
    </address>
  </publisher>

  <authorgroup>
    <author>
      <firstname>David</firstname>
      <surname>Byers</surname>
      <affiliation>
        <address><email>byers@lysator.liu.se</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>Per</firstname>
      <surname>Cederqvist</surname>
      <affiliation>
        <address><email>ceder@lysator.liu.se</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>David</firstname>
      <surname>Kågedal</surname>
      <affiliation>
        <address><email>davidk@lysator.liu.se</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>Hans</firstname>
      <surname>Persson</surname>
      <affiliation>
        <address><email>unicorn@lysator.liu.se</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>Linus</firstname>
      <surname>Tolke</surname>
      <affiliation>
        <address><email>linus@lysator.liu.se</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>Inge</firstname>
      <surname>Wallin</surname>
      <affiliation>
        <address><email>inge@lysator.liu.se</email></address>
      </affiliation>
    </author>
  </authorgroup>

  <legalnotice>
    <title>GNU General Public License</title>
    <para>
      LysKOM is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as
      published by the Free Software Foundation; either version 2, or
      (at your option) any later version.
    </para>

    <para>
      LysKOM is distributed in the hope that it will be useful, but
      WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
      General Public License for more details.
    </para>

    <para>
      You should have received a copy of the GNU General Public
      License along with LysKOM; see the file COPYING. If not, write
      to Lysator, c/o ISY, Linköping University, S-581 83 Linköping,
      SWEDEN, or the Free Software Foundation, Inc., 675 Mass Ave,
      Cambridge, MA 02139, USA.
    </para>

    <para>
      Var vänlig att rapportera eventuella fel i elispklienten eller
      någon annan del av LysKOM-systemet till
      <email>bug-lyskom@lysator.liu.se</email>.
    </para>

    <para>
      Tillstånd ges att kopiera denna manual och distribuera kopiorna,
      under förutsättning att denna copyrightnot och denna text finns
      med på alla kopior.
    </para>
  </legalnotice>
</bookinfo>

<preface>
  <title>Förord</title>

  <para>
    Det här dokumentet beskriver Emacslispklienten för LysKOM,
    <filename>lyskom.el</filename>, ofta känd som
    <quote>elispklienten</quote> eller <quote>elvispen</quote>.
  </para>

  <para>
    Meningen med detta dokument är att det ska beskriva allt man
    behöver veta om LysKOMs emacslisp-klient för att kunna använda
    den. Det förutsätts att läsaren känner till
    <command>Emacs</command>. LysKOM är i mångt och mycket gjort för
    att efterlikna QZ-KOM så om du känner till detta är det en fördel,
    men det är absolut inte nödvändigt för kunna förstå och använda
    LysKOM.
  </para>

  <para>
    Elispklienten har utvecklats mer eller mindre kontinuerligt, men
    dokumentationen till den har varit ett lite sorgligare kapitel.
    En manual skriven i <command>texinfo</command> har länge varit
    tillgänglig, men den har inte uppdaterats efter version 0.39.  Jag
    irriterade mig på det ett längre tag och började så smått att
    pilla med att uppdatera den, men körde fast i
    <command>texinfo</command> (och brist på tid).  Ett tag senare
    slog det mig att det skulle vara trevligt att skriva manualen i
    ett mer generellt format som DocBook. Det gav mig ju dessutom en
    anledning att lära mig DocBook...
  </para>

  <para>
    Hans Persson
  </para>

  <sect1>
    <title>Historia</title>
    <subtitle>Lite om KOMs historia fram till LysKOM</subtitle>

    <comment>
      Det här kapitlet saknar lite lämpliga årtal här och där.
    </comment>

    <para>
      <indexterm id="history-1">
        <primary>Linus</primary>
      </indexterm>
      <indexterm id="history-2">
        <primary>LinusKOM</primary>
      </indexterm>
      Det var en gång en teknisk högskola som hette LiTH. Där gick
      många studenter och läste en massa klokskap i diverse kurser.
      Ibland ägnade de sig även åt att diskutera med varandra med
      hjälp av ett datorbaserat konferensystem som hette KOM och körde
      på en DEC-20-dator som hette Linus. Konferensystemet kallades
      därför LinusKOM och var mycket populärt bland vissa.
    </para>

    <para>
      <indexterm id="history-3">
        <primary>QZ-KOM</primary>
      </indexterm>
      LinusKOM var ett QZ-KOM, vilket betyder att det var skapat av QZ
      i Stockholm. QZ-KOM kunde köra på DEC-10 och DEC-20-maskiner, en
      maskintyp som fanns i drift på LiTH fram till slutet av
      1980-talet. 
    </para>

    <para>
      En dag var det slutligen dags för Linus att pensioneras och
      därmed försvann också möjligheten för studenterna att använda
      LinusKOM. Det fanns inga andra DEC-20-maskiner på LiTH att
      flytta LinusKOM till, och vid det här laget hade ett svårartat
      beroende av KOM utvecklats hos vissa, så de bestämde sig för att
      skriva ett eget system som fungerade ungefär likadant som det
      hädangångna LinusKOM. Eftersom alla de som var med och skrev
      systemet i början var medlemmar i datorföreningen Lysator så
      fick det nya systemet heta LysKOM.
    </para>

    <para>
      En tidig tanke när arbetet med LysKOM började var att det skulle
      gå att ha flera olika användargränssnitt samtidigt. Någon vill
      se en grafisk struktur på hur inläggen hänger ihop på sin
      grafiska skärm, någon annan vill kunna fortsätta att använda sin
      gamla vt100-terminal. Det var också klart att systemet skulle
      köra under <productname>UNIX</productname> eftersom detta
      operativsystem bedömdes som vanligt i framtiden. Lysators
      medlemmar hade dessutom stor erfarenhet av
      <productname>UNIX</productname> och Lysator ägde ett antal
      <productname>UNIX</productname>-maskiner.
    </para>

    <para>
      Bland annat av dessa orsaker valde man att använda en
      klient-servermodell. En central server tar hand om alla inlägg
      och sköter LysKOM:s hela databas. Mot denna server kan flera
      klienter av olika sorter koppla upp sig via TCP/IP.
    </para>

    <para>
      När servern började fungera behövdes det en enkel klient för att
      lättare kunna testa den. Per Cederqvist skrev en enkel
      testklient i emacslisp som sedan har byggts på av många
      andra. Även personer utanför Lysator har bidragit till
      utvecklingen med färdiga funktioner och framför allt kommentarer
      och idéer. Det som en gång var tänkt som en temporär testrigg
      har idag förvandlats till den mest kompletta klienten för
      LysKOM, LysKOMs emacslispklient.
    </para>
  </sect1>

  <sect1>
    <title>Utveckling av elispklienten</title>
    <subtitle>Förutsättningarna för LysKOM-projektet</subtitle>

    <para>
      Nästan all utveckling av LysKOMs emacslispklient,
      LysKOM-systemet och de flesta andra i detta dokument nämnda 
      klienter är ideellt arbete utfört av medlemmar i Lysator,
      datorföreningen vid Universitet och Tekniska Högskolan i
      Linköping.
    </para>

    <para>
      Om du vill delta i arbetet så är det bra om du skaffar dig en
      ordentlig introduktion till hur systemet fungerar. Detta kräver
      att du läser dokumentationen och studerar programkoden
      ordentligt. Men för att du snabbast ska kunna lära dig systemet
      är det bäst att du kontaktar någon av utvecklarna och framför
      allt att du använder LysKOM.
    </para>

    <para>
      För den som är intresserad av att utvecka LysKOM-systemet finns
      det ett flertal möten i LysLysKOM som är intressanta.
    </para>

    <itemizedlist>
      <listitem>
        <para>LysKOM (-) Systemet, protokollet mm</para>
      </listitem>

      <listitem>
        <para>LysKOM frågor (och) svar</para>
      </listitem>

      <listitem>
        <para>LysKOM Elispklient; diskussion och idéer</para>
      </listitem>

      <listitem>
        <para>LysKOM; Elispklientens buggrapporter</para>
      </listitem>
    </itemizedlist>

    <para>
      Alla de ovanstående är öppna möten som vem som helst kan delta
      i. Det finns också ett antal slutna möten för interna
      diskussioner mellan utvecklarna. Om du är seriöst intresserad av
      att hjälpa till att utveckla LysKOM är du naturligtvis välkommen
      som medlem även i de mötena.
    </para>
  </sect1>

  <sect1>
    <title>Andra LysKOM-klienter</title>
    <subtitle>Alternativ till LysKOMs emacslispklient</subtitle>

    <para>
      Det finns vid det här laget en uppsjö av alternativa klienter
      till LysKOM förutom elispklienten. Det här kapitlet gör inga
      anspråk på att lista alla, utan bara några av de mer användbara.
      Förutom de som listas nedan finns det åtskilliga mer eller
      mindre experimentella klienter och klienter utvecklade för att
      fylla något specialiserat syfte. I LysLysKOM finns mötet
      <quote>LysKOM; Klientdiskussioner om andra klienter</quote> där
      man kan diskutera andra klienter än elispklienten. Många av
      klienterna nedan har även egna specialmöten i LysLysKOM.
    </para>

    <comment>
      Uppdatera webbsidorna om klienter och peka ut dem härifrån för
      komplett information om övriga klienter. Så mycket information
      om andra klienter som det finns nu behöver det nog inte vara
      här.
    </comment>

    <sect2>
      <title>tty-klienten</title>
      <comment>
        Informationen OK med Linus Tolke 2002-04-14.
      </comment>

      <para>
        <indexterm id="tty-1">
          <primary>Klienter</primary>
          <secondary>tty-klienten</secondary>
        </indexterm>
        <indexterm id="tty-2">
          <primary>Klienter</primary>
          <secondary>C-klienten</secondary>
        </indexterm>
        <indexterm id="tty-3">
          <primary>tty-klienten</primary>
        </indexterm>
        <indexterm id="tty-4">
          <primary>C-klienten</primary>
        </indexterm>
        tty-klienten (även kallad C-klienten) är skriven i
        <command>C</command> med det ursprungliga målet att så troget
        som möjligt likna QZ-KOM.  Avvikelser från detta mål har skett
        dels beroende på de olika förutsättningar som LysKOM har
        jämfört med QZ-KOM och dels beroende på personlig smak hos
        utvecklarna.
      </para>

      <para>
        tty-klienten är ganska stabil och lätt att kompilera och köra
        åtminstone på unixsystem där <command>gcc</command> finns
        installerad. Den senaste versionen av tty-klienten finns att
        hämta från <ulink
        url="ftp://ftp.lysator.liu.se/pub/lyskom/tty-client/">ftp://ftp.lysator.liu.se/pub/lyskom/tty-client/</ulink>.
        Mötet <quote>LysKOM ttyklienten; buggar, nyheter och
        annat.</quote> i LysLysKOM är avsett för diskussion om
        ttyklienten.
      </para>

      <para>
        Det mesta i tty-klienten är gjort av Thomas Bellman
        <email>bellman@lysator.liu.se</email>, men numera är det Linus
        Tolke <email>linus@lysator.liu.se</email> som underhåller den.
      </para>
    </sect2>

    <sect2>
      <title>kom++, nilkom och tkom</title>
      <comment>
        Informationen OK med Per Cederqvist 2002-03-28.
      </comment>

      <para>
        <indexterm id="tkom-1">
          <primary>Klienter</primary>
          <secondary>tkom</secondary>
        </indexterm>
        <indexterm id="tkom-2">
          <primary>Klienter</primary>
          <secondary>nilkom</secondary>
        </indexterm>
        <indexterm id="tkom-3">
          <primary>Klienter</primary>
          <secondary>kom++</secondary>
        </indexterm>
        <indexterm id="tkom-4">
          <primary>tkom</primary>
        </indexterm>
        <indexterm id="tkom-5">
          <primary>nilkom</primary>
        </indexterm>
        <indexterm id="tkom-6">
          <primary>kom++</primary>
        </indexterm>
        kom++ är ett klassbibliotek som erbjuder ett gränssnitt till
        LysKOM-servern som är bättre än det som LysKOM-protokollet
        erbjuder.  Det finns redan nu rutiner för cachning av personer
        och möten. kom++ är skrivet i <command>C++</command> och har
        bindningar mot <command>Python</command> och (av historiska
        skäl) <command>TCL</command>.
      </para>

      <para>
        nilkom är en terminalbaserad klient skriven i
        <command>TCL</command> med hjälp av kom++.
      </para>

      <para>
        tkom är en X-baserad klient skriven i <command>TCL</command>
        med hjälp av kom++.  Den har inte underhållits på flera år och
        fungerar inte idag.
      </para>

      <para>
        Den senaste versionen av kom++ finns att hämta från <ulink
        url="ftp://ftp.lysator.liu.se/pub/lyskom/">ftp://ftp.lysator.liu.se/pub/lyskom/</ulink>.
        nilkom och tkom ingår i samma distributionsarkiv som kom++.
      </para>
        
      <para>
        kom++, nilkom och tkom är skrivna av Per Cederqvist
        <email>ceder@lysator.liu.se</email> och Inge Wallin
        <email>inge@lysator.liu.se</email>.
      </para>
    </sect2>

    <sect2>
      <title>WinKOM</title>
      <comment>
        Informationen OK med Peter Zander 2002-03-28.
      </comment>

      <para>
        <indexterm id="winkom-1">
          <primary>Klienter</primary>
          <secondary>WinKOM</secondary>
        </indexterm>
        <indexterm id="winkom-2">
          <primary>WinKOM</primary>
        </indexterm>
        WinKOM är en LysKOM-klient för <productname>Microsoft
        Windows</productname>. Den är nog, efter elispklienten, den
        mest kompletta klienten som finns tillgänglig.
      </para>

      <para>
        Den senaste versionen av WinKOM finns att hämta från <ulink
        url="http://www.lysator.liu.se/~zander/WinKOM.html">http://www.lysator.liu.se/~zander/WinKOM.html</ulink>.
        Mötet <quote>LysKOM Windowsklient (WinKOM); nyheter,
        diskussion och idéer</quote> i LysLysKOM är avsett för
        diskussion om WinKOM.
      </para>

      <para>
        WinKOM är skrivet av Peter Zander
        <email>zander@lysator.liu.se</email>. 
      </para>
    </sect2>

    <sect2>
      <title>JySKom</title>

      <para>
        <indexterm id="jyskom-1">
          <primary>Klienter</primary>
          <secondary>JySKom</secondary>
        </indexterm>
        <indexterm id="jyskom-2">
          <primary>JySKom</primary>
        </indexterm>
        JysKOM är en server skriven i <command>Perl</command> som gör
        det möjligt att köra LysKOM via en webbläsare.
      </para>

      <comment>
        Var är Lysators JySKom-server installerad?
      </comment>

      <para>
        JySKom är skrivet av Jonas S. Karlsson
        <email>jsk@lysator.liu.se</email>. 
      </para>
    </sect2>

    <sect2>
      <title>WebKOM</title>
      <comment>
        Informationen OK med Peter Åstrand 2002-03-28.
      </comment>

      <para>
        <indexterm id="webkom-1">
          <primary>Klienter</primary>
          <secondary>WebKOM</secondary>
        </indexterm>
        <indexterm id="webkom-2">
          <primary>WebKOM</primary>
        </indexterm>
        WebKOM är, liksom JySKom, en server för att kunna läsa LysKOM
        via en webbläsare (via HTTP eller HTTPS). WebKOM är skriven i
        <command>Python</command>.
      </para>

      <para>
        Det finns en WebKOM-server installerad på Lysator med adressen
        <ulink
        url="http://webkom.lysator.liu.se/">http://webkom.lysator.liu.se/</ulink>.
        Mötet <quote>LysKOM(-klienten) WebKOM</quote> i LysLysKOM är
        avsett för diskussion om WebKOM.
      </para>

      <para>
        WebKOM är skrivet av Peter Åstrand
        <email>astrand@lysator.liu.se</email>.
      </para>
    </sect2>
  </sect1>

  <sect1>
    <title>LysKOM-servern</title>
    <subtitle>Vad är en LysKOM-server, egentligen?</subtitle>

    <para>
      <indexterm ID="server-1">
        <primary>LysKOM-server</primary>
      </indexterm>
      LysKOM-servern är en databashanterare specialskriven i C för
      ändamålet. Varje LysKOM har en egen LysKOM-server som klienter
      kan koppla upp sig mot. Lysators egen LysKOM-server,
      <quote>LysLysKOM</quote>, finns tillgänglig på <systemitem
      class="systemname">kom.lysator.liu.se</systemitem>.
    </para>

    <para>
      Databasfilen för Lysators LysKOM är läsbar för flera av Lysators
      medlemmar vilket kan tyckas vara en bugg, men den är medveten.
      Vi vill inte ge någon en falsk känska av säkerhet och på ett
      system sådant som Lysators är det alltför många som har
      privilegier för att man ska kunna garantera någon hemlighet.  På
      andra LysKOM-serverinstallationer kan situationen naturligtvis
      vara en annan.
    </para>
  </sect1>
</preface>

<chapter>
  <title>Installation</title>

  <para>
    Det här kapitlet beskriver övergripande hur man gör för att
    installera elispklienten. För mer detaljerade instruktioner, se
    filen <filename>README</filename> i elispklientdistributionen.
  </para>
  
  <sect1>
    <title>Att installera elispklienten</title>

    <para>
      <indexterm id="installation-1">
        <primary>Installation</primary>
      </indexterm>
      För att kunna installera elispklienten måste du först ha
      tillgång till den. Den senaste versionen finns alltid
      tillgänglig från <ulink
      url="ftp://ftp.lysator.liu.se/pub/lyskom/elisp-client/">ftp://ftp.lysator.liu.se/pub/lyskom/elisp-client/</ulink>.
      Hämta filen <filename>lyskom-version.tar.gz</filename> där
      version är ett versionsnummer. Ta den fil som har det högsta
      versionsnumret. När detta skrivs är 0.46.1 den senaste
      versionen.
    </para>

    <para>
      För att installera klienten, gör följande:
    </para>

    <screen>
      $ tar xfz lyskom-0.46.1.tar.gz
      $ cd lyskom-0.46.1
      $ ./configure
      $ make
      $ make install
    </screen>

    <para>
      Detta packar upp, kompilerar och installerar elispklienten. För
      att det ska gå att köra den behöver du också lägga till ett par
      rader i din <filename>.emacs</filename>-fil om du inte gjort det
      tidigare. 
    </para>

    <screen>
      (autoload 'lyskom "lyskom" "Starta LysKOM" t)
    </screen>

    <para>
      Nu ska det förhoppningsvis gå att starta elispklienten genom att
      skriva <userinput>M-x lyskom RET</userinput> inifrån
      <command>Emacs</command>. Om klienten inte startar, läs de mer
      detaljerade installationsanvisningarna i filen
      <filename>README</filename> som följer med elispklienten. 
    </para>
  </sect1>

  <sect1>
    <title>Användbara versioner av Emacs</title>

    <para>
      <indexterm id="emacs-1">
        <primary>Emacsversioner</primary>
      </indexterm>
      Eftersom <command>Emacs</command> vid det här laget är ett
      program som varit med ett tag så finns det ett flertal versioner
      i drift. Det finns dessutom två olika smaker som är nästan, men
      inte helt, kompatibla med varandra: <command>GNU Emacs</command>
      och <command>XEmacs</command>.
    </para>

    <para>
      Var och en av dessa finns dessutom naturligtvis tillgänglig i
      ett flertal versioner. För att inte göra elispklientutvecklandet
      till ett sisyfosarbete där den mesta tiden går åt till att lägga
      till stöd för gamla versioner så är stödet för äldre versioner
      begränsat. De versioner som elispklienten ska fungera i är
      dessa: 
    </para>

    <comment>
      Kontrollera att denna lista är up to date.
    </comment>

    <itemizedlist>
      <listitem>
        <para>
          <command>XEmacs</command> version 20.4, 21.1 och 21.2.
        </para>
      </listitem>

      <listitem>
        <para>
          <command>GNU Emacs</command> version 19.34. För att använda
          denna version krävs att du uppgraderar det medföljande
          custom-paketet med ett nyare. Om du använder Gnus kan du
          behöva uppdatera den också.
        </para>
      </listitem>

      <listitem>
        <para>
          <command>GNU Emacs</command> version 20.5 och nyare. Det bör
          även vara möjligt att använda version 20.2-20.4 med vissa
          problem (till exempel med tabeller).
        </para>
      </listitem>
    </itemizedlist>

    <para>
      Om du av någon anledning vill köra en äldre version av
      <command>Emacs</command> så blir du tvungen att använda en äldre
      version även av elispklienten.
    </para>
  </sect1>
</chapter>

<chapter>
  <title>Begrepp i LysKOM</title>

  <para>
    I LysKOM finns ett antal begrepp som du behöver veta vad de är
    innan det går att förklara hur elispklienten fungerar mer i
    detalj. Det här kapitlet förklarar några grundläggande begrepp.
  </para>

  <sect1>
    <title>Personer</title>

    <para>
      <indexterm id="personer-1">
        <primary>Begrepp</primary>
        <secondary>Personer</secondary>
      </indexterm>
      <indexterm id="personer-2">
        <primary>Personer</primary>
      </indexterm>
      För att du ska kunna köra LysKOM behöver du en
      <wordasword>person</wordasword>, en användaridentitet. Det
      första du måste göra för att kunna använda LysKOM är att skapa
      en egen person. 
    </para>

    <para>
      <indexterm id="lyslyskom-1">
        <primary>LysLysKOM</primary>
      </indexterm>
      Börja med att starta klienten genom att skriva <userinput>M-x
      lyskom RET</userinput> och ange vilken server du vill köra mot.
      Det finns ett antal fördefinierade publika servrar tillgängliga
      som förval. Lysators server, LysLysKOM, heter egentligen
      <systemitem class="systemname">kom.lysator.liu.se</systemitem>. 
    </para>

    <para>
      När klienten har kopplat upp sig mot servern så kommer den att
      fråga dig efter ditt namn. Det är sed att ange både för- och
      efternamn samt kanske vilken organisation du arbetar för, till
      exempel
    </para>

    <screen>
      Inge Wallin, ISY
    </screen>

    <para>
      Om du inte är från den ort där servern står (LysLysKOM står i
      Linköping) så kan det också vara trevligt att på något sätt ange
      vilken stad du normalt finns i, till exempel
    </para>

    <screen>
      Salvador Dalberg, Stacken, Stockholm
    </screen>

    <para>
      Om det inte redan finns någon person med det namn du angett så
      får du bekräfta att du stavat namnet rätt. Därefter får du ange
      ett personligt lösenord.
    </para>

    <screen>
      LysKOM elisp-klient version 0.46.2
      Försöker koppla upp mot kom.lysator.liu.se.
      Uppkopplingen klar. Serverns versionsnummer är 2.0.5.
      
      
      
      Rincewind, Unseen University, Discworld
      Det tycks vara första gången du använder LysKOM. Välkommen!
      Kontrollera att du stavat ditt namn rätt.  Använd gärna ditt fullständiga
      namn och organisation, t ex "Eskil Block, FOA".  Om du stavat ditt namn
      fel, eller vill ändra ditt namn, svara nej på frågan nedan.
      
      Observera att all information än så länge sparas så att vem som helst
      kan läsa den. Dock är lösenordet krypterat.
      
      Om du är osäker på hur man använder LysKOM kan du hämta en manual via
      anonym ftp från ftp.lysator.liu.se. Fråga din systemadministratör om
      du är osäker.
      Rincewind, Unseen University, Discworld
      Du är nu inloggad. Vänta ett tag.
      Du har blivit medlem i Presentation (av nya) möten.
      
      Gå till nästa möte - 
    </screen>

    <para>
      Som synes så blir den nyskapade personen automatiskt medlem i
      mötet <quote>Presentation (av nya) möten</quote>. I det mötet
      presenteras alla möten (mer om vad ett möte är snart) i
      KOM-systemet. Genom att vara med i det mötet får man reda på när
      det skapas nya möten om nya ämnen eller när presentationen för
      ett existerande möte ändras.
    </para>

  </sect1>

  <sect1>
    <title>Möten och brevlådor</title>

    <para>
      <indexterm id="conf-1">
        <primary>Begrepp</primary>
        <secondary>Möten</secondary>
      </indexterm>
      <indexterm id="conf-2">
        <primary>Brevlådor</primary>
      </indexterm>
      Diskussionerna i LysKOM förs i olika
      <wordasword>möten</wordasword>. Alla inlägg läggs i ett eller
      flera sådana möten och för att man ska se de inlägg som skapas
      krävs det att man är medlem i något av dessa möten. Ett möte har
      ett namn som kortfattat beskriver vad inläggen i mötet ska
      handla om. Möten har också presentationer som lite mer utförligt
      beskriver vad mötet är tänkt att handla om. När ett möte får en
      ny presentation hamnar den som vi sett ovan i mötet
      <quote>Presentation (av nya) möten</quote>. 
    </para>
      
    <para>
      De flesta möten är öppna för alla att bli medlemmar i men det
      finns också slutna möten som det krävs att man kontaktar
      administratören för mötet för att bli medlem i. Dessutom finns
      det hemliga möten, vars existens inte kan upptäckas annat än av
      medlemmarna i mötet.
    </para>

    <para>
      Om man är medlem i ett möte så betyder det att man får läsa alla
      inlägg som skrivs i det. Om man inte är inloggad i LysKOM när
      ett inlägg skrivs så kommer man att få läsa det nästa gång man
      loggar in.
    </para>
      
    <para>
      <indexterm id="conf-3">
        <primary>Begrepp</primary>
        <secondary>Organisatör</secondary>
      </indexterm>
      <indexterm id="conf-4">
        <primary>Organisatör</primary>
      </indexterm>
      Det finns inga som helst mekanismer eller garantier för att
      kontrollera att medlemmarna i ett möte skickar sina inlägg till
      rätt möte. Det finns möjligheter för
      <wordasword>organisatören</wordasword> av ett möte och
      författaren av ett inlägg att i efterhand flytta ett inlägg om
      det hamnat fel men oftast är det författarens ansvar att se till
      att det hamnar rätt från början. Övriga personer kan inte flytta
      inlägg från ett möte till ett annat, men vem som helst kan
      addera ytterligare ett möte som mottagare till ett inlägg.
    </para>

    <para>
      Det finns också en speciell sorts möten som kallas
      <wordasword>brevlådor</wordasword>. Varje person i LysKOM har en
      brevlåda som normalt bara den personen är medlem i. Andra
      personer kan skicka brev till personen via brevlådan, men en
      brevlåda är egentligen bara ett vanligt möte som är slutet
      (vilket innebär att ingen annan kan gå med i det).
    </para>

    <para>
      <indexterm id="conf-5">
        <primary>Begrepp</primary>
        <secondary>Originalmöte</secondary>
      </indexterm>
      <indexterm id="conf-6">
        <primary>Originalmöte</primary>
      </indexterm>
      <indexterm id="conf-7">
        <primary>Begrepp</primary>
        <secondary>Supermöte</secondary>
      </indexterm>
      <indexterm id="conf-8">
        <primary>Supermöte</primary>
      </indexterm>
      Ett <wordasword>originalmöte</wordasword> är ett möte där man
      inte får skriva kommentarer, bara originalinlägg. Om man
      försöker kommentera ett inlägg i ett originalmöte så kommer
      kommentaren istället att hamna i mötets
      <wordasword>supermöte</wordasword>. 
    </para>

    <comment>
      Den här sektionen borde kanske delas upp likadant som nästa?
    </comment>
  </sect1>

  <sect1>
    <title>Olika sorters texter</title>

    <para>
      <indexterm id="text-1">
        <primary>Begrepp</primary>
        <secondary>Inlägg</secondary>
      </indexterm>
      <indexterm id="text-2">
        <primary>Inlägg</primary>
      </indexterm>
      <indexterm id="text-3">
        <primary>Begrepp</primary>
        <secondary>Brev</secondary>
      </indexterm>
      <indexterm id="text-4">
        <primary>Brev</primary>
      </indexterm>
      All diskussion i LysKOM förs med
      <wordasword>inlägg</wordasword>.  Ett inlägg är en text som
      består av en <wordasword>ärenderad</wordasword> som talar om vad
      inlägget handlar om och ett antal rader text som bilder själva
      inläggskroppen. Det finns diverse olika sorters inlägg
      (<wordasword>originalinlägg</wordasword>,
      <wordasword>kommentarer</wordasword>,
      <wordasword>brev</wordasword>,
      <wordasword>fotnoter</wordasword>, etc) som kommer att gås
      igenom nedan, men alla ryms inom begreppet inlägg.
    </para>

    <para>
      <indexterm id="text-5">
        <primary>Begrepp</primary>
        <secondary>Inläggsnummer</secondary>
      </indexterm>
      <indexterm id="text-6">
        <primary>Inläggsnummer</primary>
      </indexterm>
      Diverse andra uppgifter är också associerade med ett inlägg. Vem
      som har skrivit det, när det skrevs, vilket/vilka möten det har
      som mottagare och så vidare. De hittills nämnda uppgifterna
      visas normalt av klienten när man läser ett inlägg, men det
      finns mer som oftast inte syns. Ett inlägg har också några olika
      nummer. Det viktigaste är <wordasword>inläggsnumret</wordasword>
      som helt enkelt är ett löpnummer som numrerar alla inlägg som
      skapats i den aktuella LysKOM-servern sedan den startades första
      gången. Inläggsnumret är det första som visas när ett inlägg
      skrivs ut (229662 i exemplet nedan). Ett inlägg får också ett
      löpnummer i varje möte det ligger i, och detta brukar kallas
      lokalt nummer (i det mötet). Det nedanstående inlägget har
      lokalt nummer 495 i mötet <quote>Presentation (av nya)
      möten</quote>. 
    </para>

    <para>
      Ett brev är helt enkelt ett inlägg som ligger i någons
      brevlåda. 
    </para>

    <sect2>
      <title>Originalinlägg</title>

      <para>
        <indexterm id="originaltext-1">
          <primary>Begrepp</primary>
          <secondary>Originalinlägg</secondary>
        </indexterm>
        <indexterm id="originaltext-2">
          <primary>Originalinlägg</primary>
        </indexterm>
        Ett <wordasword>originalinlägg</wordasword> är ett inlägg som
        skrivs i ett möte utan att referera till något tidigare
        existerande inlägg. Det nedanstående inlägget är ett exempel på
        det.
      </para>

      <screen>
        229662 1992-07-31 02:41 /13 rader/ Linus Tolke, Lysator, Enea Epact
        Mottagare: Presentation (av nya) möten <495>
        Markerad av 2 personer.
        Ärende: LysKOM frågor (och) svar
        ------------------------------------------------------------
        Ett m|te f|r fr}gor och svar om LysKOM. 
        
        Alla frågor som rör systemet och klienter är välkomna.
        
        Detta möte har också fungerat och kommer att fungera som en
        fråge och informationsinsamlingspunkt för frågor som rör
        elisp-klienten och de sammanställs i en Osf (Ofta ställda
        frågor).
        
        Osf finns att hämta under ftp på lysator:
        /ftp@lysator.liu.se:/pub/lyskom/elisp-client/osf-elisp-client-0.34.6.
        Den har versionsnummer som följer klienterna men uppdateras mer
        sporadiskt.
        (229662) /Linus Tolke, Lysator, Enea Epact/---------
      </screen>
    </sect2>

    <sect2>
      <title>Kommentarer</title>

      <para>
        <indexterm id="kommentar-1">
          <primary>Begrepp</primary>
          <secondary>Kommentarer</secondary>
        </indexterm>
        <indexterm id="kommentar-2">
          <primary>Kommentarer</primary>
        </indexterm>
        Normalt förs diskussionen i LysKOM genom att en person läser
        något intressant i ett inlägg och tycker att det är värt att
        kommentera. Han kan då skriva en
        <wordasword>kommentar</wordasword> till den första texten.
        Oftast kommer kommentaren att hamna i samma möte som den
        kommenterade texten, men det är inte nödvändigt att det är så.
        Det går också att flytta texter från ett möte till ett annat i
        efterhand. En kommentar skiljer sig egentligen inte på något
        grundläggande sätt från ett originalinlägg, utan skillnaden
        ligger i att en kommentar just är en kommentar till ett tidigare
        inlägg. Det går dessutom att göra ett inlägg till en kommentar
        till ett annat i efterhand, så vad som är ett originalinlägg och
        vad som är en kommentar är lite flytande. 
      </para>

      <screen>
        8127825 2002-03-12 11:52 /1 rad/ Attackbibliotekariestyrkan (vet var du bor!)
        Kommentar till text 7939281 av i}m-läsande ceder (%)
        Mottagare: Attackbibliotekariestyrkan (vet var du bor!) <194>
            Mottaget: 2002-03-12 11:52
        Mottagare: Inlägg }t mig <1839946>
        Ärende: Plö dep
        ------------------------------------------------------------
        Oook!
        (8127825) /Attackbibliotekariestyrkan (vet var du bor!)/
      </screen>

      <para>
        I det ovanstående exemplet ser vi en kommentar (som är inlägg
        nummer 8127825), skriven av <quote>Attackbibliotekariestyrkan
        (vet var du bor!)</quote> som är en kommentar till inlägg
        nummer 7939281 skriven av <quote>i}m-läsande ceder
        (%)</quote>. Vi ser också hur det kan se ut när ett inlägg
        ligger i flera möten samtidigt (inlägg 8127825 ligger dels i
        brevlådan för <quote>Attackbibliotekariestyrkan (vet var du
        bor!)</quote>, dels i mötet <quote>Inlägg }t mig</quote>).
      </para>
    </sect2>

    <sect2>
      <title>Fotnoter</title>

      <para>
        <indexterm id="fotnot-1">
          <primary>Begrepp</primary>
          <secondary>Fotnoter</secondary>
        </indexterm>
        <indexterm id="fotnot-2">
          <primary>Fotnoter</primary>
        </indexterm>
        En fotnot är, precis som en kommentar, ett inlägg som är
        knutet till ett tidigare inlägg genom en länk. En kommentar
        till ett inlägg kan vem som helst, men en fotnot kan endast
        författaren till det ursprungliga inlägget skapa.
      </para>

      <para>
        När man läser så presenteras man med antingen ett inlägg eller
        en kommentar i taget, och efter varje får man en ny prompt där
        man kan välja vad man vill göra. Om ett inlägg man läser har
        en fotnot så är grundinställningen i elispklienten att
        fotnoten visas direkt efter det ursprungliga inlägget, innan
        en ny prompt ges. Detta innebär att man kan använda fotnoter
        för att korrigera fel i inlägg man skrivit utan att behöva
        riskera att den som läser inlägget hinner drabbas av felet
        innan han ser korrigeringen (vilket risken vore större för om
        man använde en kommentar istället för en fotnot, eftersom
        kommentaren inte skulle visas samtidigt som det ursprungliga
        inlägget).
      </para>
    </sect2>

    <sect2>
      <title>Anmärkningar</title>

      <para>
        <indexterm id="anm-1">
          <primary>Begrepp</primary>
          <secondary>Anmärkningar</secondary>
        </indexterm>
        <indexterm id="anm-2">
          <primary>Anmärkningar</primary>
        </indexterm>
        En <wordasword>anmärkning</wordasword> är, liksom en fotnot,
        en text man kan hänga på en existerande text för att korrigera
        den. En anmärkning är däremot inte ett inlägg i sig självt
        utan lagras i en datastruktur i LysKOM-servern som kallas för
        <wordasword>aux-item</wordasword>. Det går inte att flytta en
        anmärkning från ett inlägg till ett annat som man kan göra med
        ett riktigt inlägg. Anmärkningar visas alltid direkt efter den
        aktuella texten; först de som är skrivna av författaren till
        inlägget och sedan de skrivna av andra. Notera också att det
        inte går att få reda på när det tillkommer en anmärkning på
        ett inlägg, och heller inte sparas någon information om vilka
        anmärkningar man läst. Detta innebär att de enda som kommer se
        anmärkningen är de som läser inlägget först efter att den
        lades till. Det i sin tur gör anmärkningar bra lämpade till
        korta noter som <quote>Oops, glömde ett "inte" före
        "klok".</quote> och direkt olämpliga för allt som någon som
        redan läst inlägget (till exempel författaren) skulle kunna
        tänkas vilja kommentera.
      </para>

      <comment>
        Här behövs ett exempel, så klart.
      </comment>
    </sect2>
  </sect1>

  <sect1>
    <title>Övriga begrepp</title>

    <sect2>
      <title>Garbning och markering</title>

      <para>
        <indexterm id="garb-1">
          <primary>Begrepp</primary>
          <secondary>Garbning</secondary>
        </indexterm>
        <indexterm id="garb-2">
          <primary>Garbning</primary>
        </indexterm>
        <indexterm id="markering-1">
          <primary>Begrepp</primary>
          <secondary>Markering</secondary>
        </indexterm>
        <indexterm id="markering-2">
          <primary>Markering</primary>
        </indexterm>
        <wordasword>Garbning</wordasword> är inte något som användaren
        av LysKOM kan utföra själv, utan en automatisk process (som
        kan slås på eller av för varje LysKOM-server).  Garbning
        innebär att LysKOM-systemet någon gång ibland (till exempel
        varje natt) går igenom alla inlägg i databasen och kollar hur
        gamla de är. Varje möte har en egenskap
        (<wordasword>garbtid</wordasword>) som talar om hur länge
        inlägg i det mötet ska sparas. Om ett inlägg är äldre än
        garbtiden för alla möten det ligger i så kommer det inlägget
        att tas bort. Den normala garbtiden för ett möte är 77 dagar,
        men den kan ändras av organisatören för mötet.
      </para>

      <para>
        När ett inlägg som har kommentarer garbas men kommentarerna
        inte gör det så kommer kommentarslänkarna också att tas bort.
        Detta innebär att en kommentar kommer att se ut som ett
        originalinlägg efter att inlägget det var en kommentar till
        garbats, vilket ibland kan leda till en viss förvirring.
      </para>

      <para>
        Om man vill att ett visst inlägg ska finnas kvar även efter
        att det blivit äldre än garbtiden för mötet det ligger i så
        kan man <wordasword>markera</wordasword> det. Inlägg som är
        markerade kommer att sparas när garbningen sker, oavsett hur
        gamla de är.
      </para>
    </sect2>

    <sect2>
      <title>Meddelanden</title>
  
      <para>
        <indexterm id="meddelanden-1">
          <primary>Begrepp</primary>
          <secondary>Meddelanden</secondary>
        </indexterm>
        <indexterm id="meddelanden-2">
          <primary>Meddelanden</primary>
        </indexterm>
        <indexterm id="meddelanden-3">
          <primary>Begrepp</primary>
          <secondary>Alarmmeddelanden</secondary>
        </indexterm>
        <indexterm id="meddelanden-4">
          <primary>Alarmmeddelanden</primary>
        </indexterm>
        <indexterm id="meddelanden-5">
          <primary>Begrepp</primary>
          <secondary>Gruppmeddelanden</secondary>
        </indexterm>
        <indexterm id="meddelanden-6">
          <primary>Gruppmeddelanden</primary>
        </indexterm>
        <indexterm id="meddelanden-7">
          <primary>Begrepp</primary>
          <secondary>Personliga meddelanden</secondary>
        </indexterm>
        <indexterm id="meddelanden-8">
          <primary>Personliga meddelanden</primary>
        </indexterm>
        Ett <wordasword>meddelande</wordasword> är en text som skickas
        ut synkront till alla avsedda mottagare som är inloggade, till
        skillnad från inlägg som snällt ligger och väntar tills man
        vill läsa dem, även om man inte var inloggad när inlägget
        skrevs. Om man inte är inloggad när ett meddelande skickas så
        får man inte se det. Det finns tre typer av meddelanden:
        <wordasword>alarmmeddelanden</wordasword>,
        <wordasword>gruppmeddelanden</wordasword> och
        <wordasword>personliga meddelanden</wordasword>.
      </para>
  
      <screen>
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        Gruppmeddelande till Fågelobservationer i Östergötland och annorstädes (import)
        från Bobo Kryss (leg. fågelnörd) (2002-03-26 20:50):
        
        2002-03-26 20:43: Taigatrast (Turdus ruficollis)
        Hagge å (Dalarna)
        Ses, stationär
        Outfärgad hane - Under dagen
        Rapportör: Bertil Rahm - Andrahandsuppgift (Rix-larm)
        ----------------------------------------------------------------
      </screen>
  
      <para>
        Ett alarmmeddelande kommer att nå alla som är inloggade på
        LysKOM-servern när det skickas. Detta kan vara ett antal hundra
        personer på en aktiv server, så tänk efter om det verkligen är
        nödvändigt att skicka ett alarmmeddelande. Meddelanden om
        systemunderhåll av LysKOM-servern brukar skickas ut som
        alarmmeddelanden. 
      </para>
  
      <para>
        Ett gruppmeddelande skickas till alla medlemmar av ett visst
        möte som är inloggade just för stunden, oavsett om de håller på
        att läsa i just det mötet eller något annat. Det finns vissa
        möten som är skapade med det uttryckliga syftet att man ska
        skicka meddelanden till dem istället för att skriva inlägg
        (<quote>pipmöten</quote>, eftersom elispklienten normalt piper
        när den tar emot ett meddelande). En anledning kan till exempel
        vara ett möte för sambeställning av pizza i ett visst
        geografiskt område; i detta fall är det svårt att skriva
        inlägg eftersom man måste ha svar direkt.
      </para>
  
      <para>
        Ett personligt meddelande är egentligen bara ett
        gruppmeddelande med en brevlåda som mottagare. Om den
        mottagande personen inte är inloggad så får man ett meddelande
        om att det personliga meddelandet inte gick fram.
      </para>
    </sect2>
  </sect1>
</chapter>

<chapter>
  <title>Köra LysKOM</title>

  <sect1>
    <title>LysKOM-användare</title>

    <sect2>
      <title>Att skapa en LysKOM-användare för första gången</title>

      <para>
        <comment>
          Exemplet med hur en ny person skapas borde vara här istället
          för i begrepp-sektionen.

          Här måste förklaras saker som namnkomplettering, hur man
          kommer åt kommandon som inte har snabbtangenter och så.
        </comment>
      </para>
    </sect2>
 
    <sect2>
      <title>Ändra personuppgifter</title>
  
      <para>
      </para>
    </sect2>
  </sect1>
  
  <sect1>
    <title>Få hjälp</title>

    <para>  
    </para>  
  </sect1>
  
  <sect1>
    <title>Hantera möten</title>
  
    <para>
      För att använda LysKOM på ett bra sätt behöver man vara med i
      ett antal möten. Varje möte har ett ämne som inläggen i mötet
      förväntas relatera till. Hur hårt detta efterlevs varierar
      väldigt mycket från möte till möte. I vissa möten kan inläggen
      handla om ungefär vad som helst, i andra säger mötets
      organisatör till (eller flyttar inlägg) om diskussionen driver
      iväg från det avsedda ämnet.
    </para>

    <sect2>
      <title>Bli medlem i möte - m</title>

      <para>
        <indexterm id="kom-add-self-1">
          <primary>Möten</primary>
          <secondary>Bli medlem i möte</secondary>
        </indexterm>
        <indexterm id="kom-add-self-2">
          <primary>Bli medlem i möte</primary>
        </indexterm>
        För att kunna börja delta i diskussionen i LysKOM måste man se
        till att bli medlem i några möten som ser intressanta ut. 
      </para>

      <para>
        Kommandot <userinput>Bli medlem i möte</userinput>
        (snabbkommando <userinput>m</userinput>) används för att bli
        medlem i ett möte. Klienten kommer att fråga efter vilket möte
        man vill gå med i. Genom att ändra på värdet för inställningen
        <guilabel>Prioritet för nya medlemsskap</guilabel> kan man
        bestämma vilken prioritet det nya mötet ska få, och därigenom
        var i listan av möten man är med i det ska hamna när man läser
        inlägg. Man kan antingen sätta den till en fast prioritet
        eller till <guilabel>Fråga varje gång</guilabel> så att man
        får möjlighet att sätta olika värden för varje möte man går
        med i. Var det nya mötet hamnar i listan relativt andra möten
        man redan är med i och som har samma prioritet styrs av
        inställningen <guilabel>Placering av nya
        medlemskap</guilabel>.
      </para>

      <screen>
        Gå till nästa möte - Bli medlem i möte
        
        Bli medlem i Nyheter om LysKOM...klart.
      </screen>

      <para>
        Ett möte kan även vara slutet, och i så fall går det inte att
        gå med i det. För att bli medlem i ett slutet möte måste man
        kontakta mötets organisatör och be att få bli medlem.
        Organisatören använder sedan <userinput>Addera
        medlem</userinput> för att lägga till den nya medlemmen.
      </para>

      <screen>
        Bli medlem i Anonyma biblioholister (Legere necesse est)...det gick inte.
        Anonyma biblioholister (Legere necesse est) är slutet.
        Skicka ett brev till Hans Persson (Oook!) för medlemskap.
      </screen>

      <para>
        Det går även att använda <userinput>Bli medlem i
        möte</userinput> för att ändra prioritet på ett möte som man
        redan är medlem i.
      </para>

      <comment>
        Den gamla dokumentationen nämner
        kom-membership-default-priority och
        kom-membership-default-placement. Jag har valt att inte göra
        det utan tala om rubrikerna i inställningsbufferten istället.
      </comment>
    </sect2>

    <sect2>
      <title>Gå till möte - g</title>

      <para>
        <indexterm id="kom-go-to-conf-1">
          <primary>Möten</primary>
          <secondary>Gå till möte</secondary>
        </indexterm>
        <indexterm id="kom-go-to-conf-2">
          <primary>Gå till möte</primary>
        </indexterm>
        Kommandot <userinput>Gå till möte</userinput> (snabbkommando
        <userinput>g</userinput>) låter användaren gå till ett nytt
        möte för att börja läsa inlägg där istället för där läsningen
        nu sker. Klienten frågar efter vilket möte du vill gå till. Om
        du inte redan är medlem i mötet så frågar klienten om du vill
        bli det, och om man svarar <userinput>j</userinput> så blir
        man medlem i mötet på samma sätt som om man hade använt
        <userinput>Bli medlem i möte</userinput>. Efter det går man till
        mötet på vanligt sätt.
      </para>

      <screen>
        Gå till nästa möte - Gå till möte
        
        Gå till Nyheter om LysKOM.
        Nyheter om LysKOM - 82 olästa
        
        Läsa nästa text - 
      </screen>

      <para>
        Genom att ändra på värdet för inställningen <guilabel>Visa
        olästa när man går till ett möte</guilabel> kan man bestämma
        om antalet olästa inlägg man har i mötet man går till ska
        visas när man går till mötet eller inte. Normalinställningen
        är som ovan, att antalet olästa inlägg i ett möte visas när
        man går till mötet.
      </para>
    </sect2>

    <sect2>
      <title>Utträda ur möte</title>

      <para>
        <indexterm id="kom-sub-self-1">
          <primary>Möten</primary>
          <secondary>Utträda ur möte</secondary>
        </indexterm>
        <indexterm id="kom-sub-self-2">
          <primary>Utträda ur möte</primary>
        </indexterm>
        Kommandot <userinput>Utträda ur möte</userinput> (inget
        snabbkommando) låter användaren sluta vara medlem i ett möte.
        Klienten frågar efter vilket möte man vill utträda ur (med det
        möte man befinner sig i för stunden som förval).
      </para>

      <screen>
        Läsa nästa text - Utträda ur möte
        
        Utträda ur Nyheter om LysKOM...klart.
        Du är nu passiv medlem i Nyheter om LysKOM.
        Utträd ur mötet en gång till för gå ur helt.
        
        Gå till nästa möte - Lista nyheter
      </screen>

      <para>
        Som synes så blir man normalt passiv medlem i ett möte när man
        utträder ur det. Det betyder att mötet till exempel inte
        kommer att listas när man gör <userinput>Lista
        nyheter</userinput>, men LysKOM kommer fortfarande att hålla
        reda på vilka inlägg i mötet man läst. En nackdel är att ju
        fler möten man är med i, desto längre tid tar det att logga in
        i LysKOM. Om man vill gå ur ett möte helt så kan man helt
        enkelt utföra kommandot <userinput>Utträda ur möte</userinput>
        en gång till (och då kommer LysKOM att glömma bort vilka
        inlägg i mötet man läst). Om man inte vill att man ska bli
        passiv medlem när man utträder ur ett möte så kan man ändra
        värdet på inställningen <guilabel>Utträda ur möte gör om
        medlemskap till passiva</guilabel>.
      </para>
    </sect2>

    <sect2>
      <title>Skapa möte</title>

      <para>
        <indexterm id="kom-create-conf-1">
          <primary>Möten</primary>
          <secondary>Skapa möte</secondary>
        </indexterm>
        <indexterm id="kom-create-conf-2">
          <primary>Skapa möte</primary>
        </indexterm>
        Kommandot <userinput>Skapa möte</userinput> (inget
        snabbkommando) låter användaren skapa ett nytt möte. Klienten
        ställer sedan ett antal frågor om det nya mötet: vad det ska
        heta, om vem som helst får bli medlem (om mötet ska vara
        öppet), om man får skriva kommentarer (om det ska vara ett
        originalmöte), om man får skriva anonyma texter och om man får
        gå med som hemlig medlem. Efter det är mötet skapat och man
        görs till medlem av det. Sedan öppnas en edit-buffert där man
        förväntas skriva en presentation av det nya mötet.
      </para>

      <screen>
        Gå till nästa möte - Skapa möte
        
        Möte nummer 10840 Min dagbok, skapat.
        Bli medlem i Min dagbok...klart.
        
        Gå till nästa möte - 
      </screen>
    </sect2>

    <sect2>
      <title>Utplåna (möte/person)</title>

      <para>
        <indexterm id="kom-delete-conf-1">
          <primary>Möten</primary>
          <secondary>Utplåna (möte/person)</secondary>
        </indexterm> 
        <indexterm id="kom-delete-conf-2">
          <primary>Utplåna (möte/person)</primary>
        </indexterm> 
        Kommandot <userinput>Utplåna (möte/person)</userinput> (inget
        snabbkommando) tar bort ett möte eller en person. Klienten
        frågar först vilket möte man vill ta bort och ber sedan
        användaren att bekräfta innan mötet tas bort. För att kunna ta
        bort ett möte eller en person måste man vara organisatör för
        det som ska tas bort.
      </para>

      <screen>
        Läsa nästa text - Utplåna (möte/person)
        
        Ok, nu är Min dagbok utplånad.
        Du är inte längre medlem i Min dagbok.
        
        Läsa nästa text - 
      </screen>
    </sect2>

    <sect2>
      <title>Ändra mötesuppgifter</title>

      <para>
        Det finns ett antal olika funktioner man kan använda för att
        ändra egenskaper hos ett redan skapat möte som man är
        organisatör för.
      </para>

      <sect3>
        <title>Ändra FAQ</title>

        <para>
          <indexterm id="conf-change-faq-1">
            <primary>Möten</primary>
            <secondary>Ändra FAQ</secondary>
          </indexterm>
          <indexterm id="conf-chance-faq-2">
            <primary>Ändra FAQ</primary>
          </indexterm>
          Kommandot <userinput>Ändra FAQ</userinput> (inget
          snabbkommando) används för att ändra i ett mötes FAQ.
          Klienten frågar efter vilket möte man vill ändra FAQ för,
          och öppnar sedan en edit-buffert så att man kan ändra den. 
        </para>
      </sect3>

      <sect3>
        <title>Addera FAQ</title>

        <para>
          <indexterm id="conf-add-faq-1">
            <primary>Möten</primary>
            <secondary>Addera FAQ</secondary>
          </indexterm>
          <indexterm id="conf-add-faq-2">
            <primary>Addera FAQ</primary>
          </indexterm>
          Kommandot <userinput>Addera FAQ</userinput> (inget
          snabbkommando) används för att sätta ett existerande inlägg
          som FAQ för ett möte. Klienten frågar efter vilket möte man
          vill addera en FAQ för och sedan vilket inlägg man vill
          addera som FAQ.
        </para>

        <screen>
          Gå till nästa möte - Addera FAQ
          
          Lägger till inlägg 8212575 som FAQ för Min dagbok...klart.
          
          Gå till nästa möte - 
        </screen>
      </sect3>

      <sect3>
        <title>Ändra livslängd</title>

        <para>
          <indexterm id="conf-change-life-1">
            <primary>Möten</primary>
            <secondary>Ändra livslängd</secondary>
          </indexterm>
          <indexterm id="conf-chance-life-2">
            <primary>Ändra livslängd</primary>
          </indexterm>
          Kommandot <userinput>Ändra livslängd</userinput> (inget
          snabbkommando) ändrar livslängden på inlägg i ett möte. När
          ett inlägg blivit äldre än livslängden för mötet så kan det
          komma i fråga för garbning. Klienten frågar först efter
          vilket möte man vill ändra livslängden för, sedan hur många
          dagar man vill att livslängden ska vara.
        </para>

        <screen>
          Gå till nästa möte - Ändra livslängd
          
          Ändra livslängden för Min dagbok till 17...klart.
          
          Gå till nästa möte - 
        </screen>
      </sect3>

      <sect3>
        <title>Ändra mötestyp</title>

        <para>
          <indexterm id="conf-change-type-1">
            <primary>Möten</primary>
            <secondary>Ändra mötestyp</secondary>
          </indexterm>
          <indexterm id="conf-chance-type-2">
            <primary>Ändra mötestyp</primary>
          </indexterm>
          Kommandot <userinput>Ändra mötestyp</userinput> (inget
          snabbkommando) ändrar några inställningar för mötet. Efter
          att man talat om vilket möte man vill ändra inställningarna
          för så får man svara på frågorna <guilabel>Får vem som helst
          bli medlem</guilabel>, <guilabel>Får man skriva
          kommentarer</guilabel>, <guilabel>Får man skriva anonyma
          texter</guilabel> och <guilabel>Får man gå med som hemlig
          medlem</guilabel>. 
        </para>

        <screen>
          Gå till nästa möte - Ändra mötestyp
          
          Ändra mötestyp för möte Min dagbok (10842) anonymt ok
          
          Gå till nästa möte - 
        </screen>
      </sect3>

      <sect3>
        <title>Ändra organisatör</title>

        <para>
          <indexterm id="conf-change-org-1">
            <primary>Möten</primary>
            <secondary>Ändra organisatör</secondary>
          </indexterm>
          <indexterm id="conf-chance-org-2">
            <primary>Ändra organisatör</primary>
          </indexterm>
          Kommandot <userinput>Ändra organisatör</userinput> (inget
          snabbkommando) ändrar organisatören för ett möte. Klienten
          frågar först efter vad som organisatören ska ändras för,
          sedan vem som ska bli den nya organisatören. 
        </para>

        <para>
          Genom att sätta organisatören för ett möte till mötet självt
          så kan man låta alla medlemmar i mötet fungera som
          organisatör.
        </para>

        <screen>
          Läsa nästa text - Ändra organisatör
          
          Ändra organisatör för Min dagbok till Hans Persson (Oook!)...klart.
          
          Läsa nästa text - 
        </screen>
      </sect3>

      <sect3>
        <title>Ändra presentation</title>

        <para>
          <indexterm id="conf-change-pres-1">
            <primary>Möten</primary>
            <secondary>Ändra presentation</secondary>
          </indexterm>
          <indexterm id="conf-chance-pres-2">
            <primary>Ändra presentation</primary>
          </indexterm>
          Kommandot <userinput>Ändra organisatör</userinput> (inget
          snabbkommando) ändrar presentationen för ett möte (eller
          skapar en, om det inte finns någon). Klienten frågar först
          efter vad presentationen ska ändras för, och öppnar sedan en
          vanlig edit-buffert.
        </para>

        <screen>
          Läsa nästa text - Ändra presentation
          
          
          Text nummer 8212575 är skapad.
        </screen>
      </sect3>

      <sect3>
        <title>Ändra supermöte</title>

        <para>
          <indexterm id="conf-change-super-1">
            <primary>Möten</primary>
            <secondary>Ändra supermöte</secondary>
          </indexterm>
          <indexterm id="conf-chance-super-2">
            <primary>Ändra supermöte</primary>
          </indexterm>
          Kommandot <userinput>Ändra supermöte</userinput> (inget
          snabbkommando) ändrar supermöte för något. Om man inte får
          skriva kommentarer i ett möte så hamnar de istället i
          supermötet. Klienten frågar efter vilket möte man vill ändra
          supermöte för.
        </para>

        <screen>
          Gå till nästa möte - Ändra supermöte
          
          Ändra supermöte för Min dagbok till /dev/null...klart.
          
          Gå till nästa möte - 
        </screen>
      </sect3>

      <sect3>
        <title>Ändra tillåtna författare</title>

        <para>
          <indexterm id="conf-change-allowed-1">
            <primary>Möten</primary>
            <secondary>Ändra tillåtna författare</secondary>
          </indexterm>
          <indexterm id="conf-chance-allowed-2">
            <primary>Ändra tillåtna författare</primary>
          </indexterm>
          Kommandot <userinput>Ändra tillåtna författare</userinput>
          (inget snabbkommando) ändrar vilka som får skriva i ett
          möte. Klienten frågar först efter vilket möte som ska
          påverkas och sedan vilka som ska få skriva i mötet. Det kan
          anges antingen genom att svara <guilabel>alla</guilabel>
          (vilket är standardsvaret) eller genom att svara med namnet
          på ett annat möte. Om man anger ett möte så betyder det att
          alla som är medlemmar i det andra mötet får skriva i det
          möte man ändrar.
        </para>

        <screen>
          Läsa nästa text - Ändra tillåtna författare
          
          Tillåt alla författare i möte Min dagbok...klart.
          
          Läsa nästa text - 
        </screen>
      </sect3>
    </sect2>

    <sect2>
      <title>Addera medlem</title>

      <para>
        <indexterm id="kom-add-member-1">
          <primary>Möten</primary>
          <secondary>Addera medlem</secondary>
        </indexterm> 
        <indexterm id="kom-add-member-2">
          <primary>Addera medlem</primary>
        </indexterm> 
        Kommandot <userinput>Addera medlem</userinput> (inget
        snabbkommando) används för att addera en person som medlem
        till ett möte. Detta är det enda sättet som finns för att låta
        personer bli medlemmar i slutna möten (och kan då bara
        användas av det slutna mötets organisatör). Det kan också
        användas för att addera medlemmar till en persons brevlåda om
        man vill att någon annan ska kunna läsa dennes post. Klienten
        frågar först efter vem man vill addera till ett möte, sedan
        vilket möte personen ska adderas till, och till sist vilken
        prioritet mötet ska få.
      </para>

      <screen>
        Gå till nästa möte - Addera medlem
        
        Addera Hans Persson (Oook!) som medlem i Min dagbok...klart.
        
        Gå till nästa möte - 
      </screen>
    </sect2>

    <sect2>
      <title>Uteslut medlem</title>

      <para>
        <indexterm id="kom-sub-member-1">
          <primary>Möten</primary>
          <secondary>Uteslut medlem</secondary>
        </indexterm>  
        <indexterm id="kom-sub-member-2">
          <primary>Uteslut medlem</primary>
        </indexterm>  
        Kommandot <userinput>Uteslut medlem</userinput> (inget
        snabbkommando) används för att ta bort en person som medlem
        från ett möte. Klienten frågar först efter vem man vill
        utesluta, sedan vilket möte man vill utesluta dem från.
      </para>

      <screen>
        Gå till nästa möte - Uteslut medlem

        Utesluta Hans Persson (Oook!) från Min dagbok...klart.
        
        Gå till nästa möte - 
      </screen>
    </sect2>
  </sect1>
  
  <sect1>
    <title>Läsa inlägg</title>
  
    <para>
      För att kunna delta i debatten i LysKOM måste man kunna läsa
      texter som andra skrivit. Olika kommandon för att göra det
      beskrivs i det här avsnittet.
    </para>

    <sect2>
      <title>Läsa nästa inlägg - ni / Läsa nästa kommentar - nk</title>

      <para>
        <indexterm id="kom-read-next-text-1">
          <primary>Läsning</primary>
          <secondary>Läsa nästa inlägg</secondary>
        </indexterm>
        <indexterm id="kom-read-next-text-2">
          <primary>Läsa nästa inlägg</primary>
        </indexterm>
        <indexterm id="kom-read-next-text-3">
          <primary>Läsning</primary>
          <secondary>Läsa nästa kommentar</secondary>
        </indexterm>
        <indexterm id="kom-read-next-text-4">
          <primary>Läsa nästa kommentar</primary>
        </indexterm>
        Det finns kommandon för att explicit säga att man vill läsa
        nästa olästa inlägg eller nästa olästa kommentar. Normalt sett
        använder man inte dem för att läsa utan man trycker helt
        enkelt på mellanslag för att visa nästa text. Vilket kommando
        som kommer att utföras när man trycker på mellanslag (eller
        return) varierar lite, men så länge man har olästa texter så
        visar prompten ett läskommando (eller ett kommando för att gå
        till nästa möte, så att man kan fortsätta att läsa texter
        där). Om man istället trycker på linefeed (eller control-j) så
        utförs det aktuella kommandot från prompten på samma sätt som
        ovan, men inlägget skrivs ut från toppen av fönstret istället
        för att scrolla fram.
      </para>

      <comment>
        Uppmärkning av några tangenttryckningar saknas i föregående
        stycke. 
      </comment>

      <para>
        Om man håller på att återse när något av kommandona
        <userinput>Läsa nästa inlägg</userinput> ges så kommer
        informationen om vad man höll på att återse undan. Med
        <userinput>Återse nästa</userinput> kan man senare återgå till
        att återse (eller så görs det automatiskt när man inte har
        fler olästa texter kvar).
      </para>
    </sect2>

    <sect2>
      <title>Endast läsa senaste - e</title>

      <para>
        <indexterm id="kom-set-unread-1">
          <primary>Läsning</primary>
          <secondary>Endast läsa senaste</secondary>
        </indexterm>
        <indexterm id="kom-set-unread-2">
          <primary>Endast läsa senaste</primary>
        </indexterm>
        Ibland händer det att man får massor av olästa texter i ett
        möte som man inte har lust att läsa. Det kan bero på att man
        gått med i mötet nyligen eller att man varit på
        semester. Genom att använda <userinput>Endast läsa
        senaste</userinput>slipper man sitta och trycka sig förbi alla
        inaktuella inläggen. Man får ange hur många texter man vill ha
        kvar i mötet, de övriga markeras som lästa.
      </para>

      <screen>
        Gå till nästa möte.
        
        Svenska Dagbladet (import av nyheter) - 1302 olästa
        
        Läsa nästa text - Endast läsa senaste
        
        Svenska Dagbladet (import av nyheter) - 25 olästa
        
        Läsa nästa text - 
      </screen>
    </sect2>

    <sect2>
      <title>Uppskjuta läsning - e</title>

      <para>
        <indexterm id="kom-postpone-1">
          <primary>Läsning</primary>
          <secondary>Uppskjuta läsning</secondary>
        </indexterm>
        <indexterm id="kom-postpone-2">
          <primary>Uppskjuta läsning</primary>
        </indexterm>
        Ibland händer det att man får massor av olästa texter i ett
        möte som man visserligen vill läsa men inte har tid med just
        nu. Man vill dock inte kasta bort dem helt som med
        <userinput>Endast läsa senaste</userinput>. Genom att använda
        <userinput>Uppskjuta läsning</userinput> så kan man begränsa
        antalet inlägg man får läsa i det aktuella mötet till ett
        antal man anger; resten av inläggen sparas till nästa
        session. Man får ange hur många texter man vill läsa nu i
        mötet.  Resten sparas till nästa session.
      </para>

      <screen>
        Häftiga Länkar (ingen URL i ärenderaden tack! /org) - 857 olästa.

        Läsa nästa text - Uppskjuta läsning


        Läsa nästa text - 
      </screen>

      <comment>
        Exemplet ovan är rätt meningslöst. Det är buggrapporterat att
        det saknas feedback, så förhoppningsvis är exemplet snart
        inaktuellt. 
      </comment>
    </sect2>

      <sect2>
        <title>Unfinished stuff</title>
      <para>
    Läsa inlägg
      Vanlig läsning
      Endast läsa senaste
      Uppskjuta läsning
      Återse
      Filtrering
      Markering
      </para>
        </sect2>
  </sect1>
  
  <sect1>
    <title>Skriva inlägg</title>
  
    <para>  
    </para>  
  </sect1>
  
  <sect1>
    <title>Informationskommandon</title>
 
    <para>  
    </para>  
  </sect1>
  
  <sect1>
    <title>Meddelanden</title>
  
    <para>  
    </para>  
  </sect1>
  
  <sect1>
    <title>Diverse</title>
  
    <para>  
    </para>  
  </sect1>
</chapter>
  
<chapter>
  <title>Inställningar</title>
  
  <para>  
  </para>  
</chapter>
  
<chapter>
  <title>Buggrapporter</title>
  
  <para>  
  </para>  
</chapter>
  
<chapter>
  <title>Administratörskommandon</title>

  <para>
<comment>
Här är ett förslag på struktur för hela manualen. Sektioner som börjar
med "#" är "färdiga".

Struktur
========
# Författare
# Licens
  Kodare
  Meny

  Förord
#   Historia
#   Utveckling av elispklienten
#   Andra LysKOM-klienter
#   LysKOM-servern
# Installation
#   Att installera elispklienten
#   Användbara versioner av Emacs [något om gamla Emacsen?]
    Att starta elispklienten
      [underkapitel Lysator och Andra maskiner tas bort]
  Begrepp i LysKOM
#   Personer
#   Möten och brevlådor
#   Olika sorters texter
#     Originalinlägg
#     Kommentarer
#     Fotnoter
#     Anmärkningar
#   Övriga begrepp
#     Garbning
#     Meddelanden
  Köra LysKOM
    LysKOM-användare
      Att skapa en LysKOM-användare för första gången
      Skapa användare
      Ändra personuppgifter
    Få hjälp
#     Att hantera möten
#       Bli medlem
#       Skapa möte
#       Ändra mötesuppgifter
    Läsa inlägg
      Vanlig läsning
      Återse
      Filtrering
      Markering
    Skriva inlägg
      Nytt inlägg
      Kommentar
      Brev
      Anonyma inlägg
    Informationskommandon
      Lista
      Status
    Meddelanden
      Sända meddelanden
      Alarmmeddelanden
      Telefonsvarare
    Diverse
      Sluta
      Ändra
      Spara text
      Addera och subtrahera
      Fjärrstyrning
    Prompten
    Färgläggning [rubrik?]
      [namn, nummer, mushantering, kontextmeny, *, vinkel-möte 6-vinkel]
    Scrollning (SPC, RET, DEL, etc)
    Namn och namnkomplettering [senare]
  Inställningar
    Ändra inställningar
    Prioritera möten
    Flaggor
    Variabler
    Hookar
    Environmentvariabler
  Buggrapporter
  Administratörskommandon
  Index
    Filer ???
    Index
    Tangenterna
    Variabelindex
    Hookar, etc ???
  
  Lägg till ett "Kom igång snabbt"-kapitel.


Kolla även http://www.lysator.liu.se/~padrone/kom/om-kom.html.

8744374 idag 15:42 /19 rader/ David Byers
Kommentar till text 8744212 av Lappnarr (sommarledig)
Mottagare: LysKOM Elispklient; diskussion och idéer <13701>
Extra kopia: LysKOM Windowsklient (WinKOM); nyheter, diskussion och idéer <2856>
Ärende: Länkar inom parantes
------------------------------------------------------------
Elispklienten fungerar lite annorlunda. Dels tillåter den URLer som
inte uppfyller RFC 1738 (vi tillåter att tecken som egentligen ska
vara kodade att förekomma okodade) och dels så ser vi till att sista
tecknet i den markerade URLen inte är citationstecken, vinklar,
krullar, parenteser, punkt, komma, utropstecken, frågetecken,
apostrof, kolon, eller vertikalt streck. Antagligen kommer jag att
lägga in hakparenteser och semikolon i den listan i kväll.

Det innebär att vi klarar att folk skriver URLer i parenteser
(http://www.dictionary.com/search?q=parenthesis) och mitt i meningar,
som http://www.dictionary.com/search?q=comma, men om man har en URL
som ska sluta med något av ovanstående tecken så kommer den att märkas
upp fel. Det tycker jag är en vettig avvägning eftersom URLer som
avslutas med underliga tecken inte är så vanliga.

Om man vill vara garanterad att ens URL inte tolkas fel så måste man
märka upp den enligt appendixet i RFC 1738 &lt;URL:http://www.cis.ohio
-state.edu/cgi-bin/rfc/rfc1738.html&gt;. Då kan man till och med bryta
URLen över flera rader.
(8744374) /David Byers/-----------------------------

</comment>
  </para>  
</chapter>

<!--&genindex.sgm;-->

</book>
