Compare revisions

*~

.#*

#

# $Id$

# Copyright (C) 1991, 1996  Lysator Academic Computer Association.

#

# This file is part of the LysKOM server.

doc:

	( cd doc; $(MAKE) )

install:

	( cd src; $(MAKE) install )

	( cd doc; $(MAKE) install )

release:

	( cd src; $(MAKE) release )

	( cd doc; $(MAKE) release )

	( cd doc; ${MAKE} clean )

	( cd misc; ${MAKE} clean )

distclean: clean

	( cd src; ${MAKE} distclean )

debian-package:

	( cd src; $(MAKE) debian-package )

debian-packages:

	( cd src; $(MAKE) debian-packages )

DefaultType text/plain

#

# $Id$

# Copyright (C) 1991, 1996  Lysator Academic Computer Association.

#

# This file is part of the LysKOM server.

#

# Please mail bug reports to bug-lyskom@lysator.liu.se.

CLIENTVERSION = 0.46.1-BETA-5

CLIENTVERSION = 0.48

SHELL = /bin/sh

RM = rm -f

	$(RM) *.toc

	$(RM) *.bbl *.blg *.idx *.ilg *.ind *.log

	$(RM) core *~

# Fultargets fr dokumentationen. Jag har inte ens frskt att gra 

# ngot som ngon annan har nytta av n.

verify:

	nsgmls -sv -c catalog elisp-client.sgml

tex:

	jade -t tex -c catalog elisp-client.sgml

	jadetex elisp-client.tex

html:

	openjade -t sgml \

	         -d /local/sgml/style/dsssl/docbook/html/docbook.dsl \

	         elisp-client.sgml

** Om det kommer asynkrona meddelanden lite olyckligt så kommer

   kom-first-line-face att användas på för många rader. Den här buggen

   är har låg prioritet.

   har låg prioritet.

** Återse senaste fungerar dåligt. Överhuvudtaget finns det många

   problem med återsefunktionerna som inte är rättade. De här buggarna

** Om det kommer asynkrona meddelanden lite olyckligt så kommer

   kom-first-line-face att användas på för många rader. Den här buggen

   är har låg prioritet. Eventuellt är buggen fixad: ingen minns

   säkert.

   har låg prioritet. Eventuellt är buggen fixad: ingen minns säkert.

** Om man går ur ett möte medan man prioriterar möten kan man inte

   spara den nya prioriteringen. Denna bug kommer nog att fixas på

                      Nyheter i lyskom.el 0.46.1

                      ==========================

    Version 0.46.1 rättar vissa fel som finns i 0.46. Den finns att

    hämta på följande adress:

    Version 0.46.1 rättar vissa fel som finns i 0.46 och innehåller

    också en del mindre förbättringar. Den finns att hämta på följande

    adress:

       <URL:ftp://ftp.lysator.liu.se/pub/lyskom/elisp-client/>

    eller set-buffer-multibyte i din .emacs.

    XEmacs 21.2

    -----------

    En del användare har rapporterat problem i med elispklienten i

    XEmacs 21.2. Om klienten fungerar i XEmacs 21.2 så är det ren tur.

    Om den inte fungerar så är det dags att uppgradera till en

    tidigare version. När XEmacs 21.2 har börjat stabiliseras så

    kommer säkert någon att se till att elispklienten fungerar där.

    Kompilering

    -----------

    Till skillnad från tidigare versioner så måste man kompilera den

    här versionen av klienten för att den skall fungera. This is not a

    bug. It's a feature. Felmeddelandet man får om man inte kompilerar

    är kryptiskt.

    Från och med version 0.46 måste man kompilera klienten för att den

    skall fungera. This is not a bug. It's a feature. Felmeddelandet

    man får om man inte kompilerar är kryptiskt.

    Kompilera för den version av Emacs som du tänker använda. Det

    finns kontroller som skall hindra att man försöker köra klienten i

   Den här funktionen fungerar bara om man kör mot lyskomd version

   2.0.0 eller nyare.

** Ändra parentes klarar av mer komplicerade namn.

** Ändra parentes klarar av mer komplicerade namn, och prompten som

   frågar efter namnet som ska ändras har den inloggade personen som

   defaultvärde.

** RydKOM har flyttats till kom.hem.liu.se.

** När klienten frågar om man vill addera den kommenterades brevlåda

   om man skriver en kommentar i ett möte där den kommentarade inte är

   om man skriver en kommentar i ett möte där den kommenterade inte är

   medlem får man numera en fråga om huruvida det skall vara en extra

   kopiemottagare eller vanlig mottagare.

** Repliker gjorda av författaren till ett inlägg visas före andra

   repliker.

** Det som förut kallades "korta repliker" heter nu "anmärkningar".

** Anmärkningar gjorda av författaren till ett inlägg visas före andra

   anmärkningar (förutom när inlägget återses omodifierat).

** Om nästa inlägg är en bilaga till ett importerat e-brev blir

   prompten "Läsa nästa bilaga". Åtminstone ibland.

** En del funktionalitet som tidigare var begränsad till XEmacs finns

   även i Emacs 21:

* Bugfixar

* Buggfixar

** Klienten fungerar i Gnu Emacs 21.

   normal läsning, inte (som förut) två gånger.

** Det ska nu gå att klistra in text i inläggsediteringsbuffertar med

   mittenmusknappen i alla Emacs-sorter.  Säg till om det inte

   fungerar för dig!

   mittenmusknappen i alla Emacs-sorter.

** Problemet med att klienten ibland hänger om man har asynkrona

   meddelanden omstyrda till en egen buffert är antagligen åtgärdat.

                      Nyheter i lyskom.el 0.47.1

                      ==========================

    Version 0.47 av elispklienten innehåller ett stort antal bugfixar

    och ny funktionalitet. Den finns att hämta på följande adress:

      <URL:http://www.lysator.liu.se/lyskom/klienter/emacslisp/>

      <URL:ftp://ftp.lysator.liu.se/pub/lyskom/elisp-client/>

    Filen heter lyskom-0.47.1.tar.gz, och en kopia av den text du

    läser just nu finns under namnet NEWS-0.47.1 i tar-arkivet. Det

    finns även en zip-fil för folk som sitter med system som inte

    förstår tar-filer.

    Det finns viktig information i NEWS-0.47 som också ingår i

    tar-arkivet och zip-filen.

    Version 0.47.1 rättar ett antal fel och kommer med några smärre

    förbättringar gentemot 0.47. Alla bör uppgradera eftersom en del

    av felen var rätt allvarliga.

* Features och förbättringar

** Klienten kontrollerar några delar av Emacs-konfigurationen vid

   start och varnar om den hittar något som kan orsaka problem.

** Variabeln kom-mark-read-texts-as-read-in-new-recipient är satt till

   t (default är nil) så kommer inlägg som adderas till nya möten inte

   att läsmarkeras automatiskt (bug 832).

** Om servern har en lapp på dörren så visas den tydligare än

   tidigare. Klientens defaultinställningar används vid visningen

   eftersom den görs före inloggning (bug 522).

** När man skickar in inlägg anonymt och ens brevlåda är mottagare

   till inlägget så får man en fråga om man vill ta bort sin brevlåda

   från mottagarlistan (bug 722).

** Radera inlägg visar en stor varning och frågar två gånger om man

   verkligen vill radera inlägg, förutsatt att inlägget har

   kommentarer (bug 679).

** Status (för) person räknar olästa inlägg i möten med passiva

   medlemskap separat (bug 746).

** Status (för) person och Status (för) möte visar passiva medlemskap

   i en blekare färg än aktiva medlemskap.

** Man får en meny när man trycker "*" på tilläggsinformation medan

   man skriver inlägg. (bug 750).

** Bättre användargränssnitt för Lista (med) regexpar (bug 752).

** Ändra parentes skriver ut en hänvisning till Ändra namn om namnet

   inte är sådant att Ändra parentes kan hantera det (bug 826).

** Återse FAQ fyller i prompten med aktuellt möte. Om man rensar

   minibufferten så får man se FAQ för servern (bug 767).

** Fler kommandon i menyerna (bug 727, patch från Per Starbäck).

** Skönsvärdet för kom-created-texts-are-read är numera nil så att nya

   användare får se sina egna inlägg.

** Elispklienten gör vissa grundläggande kontroller av Emacs

   konfiguration när den startar. Detta går att styra med variabeln

   kom-check-configuration-on-startup. Denna inställning finns för

   närvarande inte tillgänglig via Inställningar (för) LysKOM och kan

   komma att ändras eller tas bort i framtiden.

* Bugfixar

** Kommandot "Sätt loginmeddelande" är mer stabilt och väljer nu en

   mottagare automatiskt (bug 762).

** Extra-kopiemottagare och dolda kopior fungerar i edit-bufferten

   även med engelska texter (bug 763).

** Kommandot "Se diff" fungerar i XEmacs (bug 757).

** Man kan ge kommandon som arbetar på inlägg innan man har läst något

   utan att det kommer upp ett felmeddelande (bug 733).

** Flera kommandon, bland annat Fotnot till inlägg, som arbetade på

   fel inlägg väljer nu rätt inlägg.

** Man kan läsa HTML-inlägg i XEmacs även med alternativa

   inläggsbakgrunder påslagna (bug 739, 821, 825).

** Prompten tas bort om man gör Avsluta och inte använder ssh-proxy

   (bug 745, 764).

** Funktion i Emacs utan multibyteteckenstöd men med MULE-funktioner

   är återställd.

** Fönstertiteln i Windows saknar en ful ruta (bug 738).

** Bättre ledtexter när man öppnar URLer på Windows (bug 717).

** Addera lapp på dörren har nu rätt ledtexter (bug 728, patch från

   Per Starbäck).

** Variabeln kom-bury-buffers används även när man byter LysKOM på

   grund av att man har kom-server-priority-breaks satt (bug 717,

   patch från Christer Ekholm).

** Bytte namn från lyskom-old-farts-text-prompt-strategy till

   kom-old-farts-text-prompt-strategy. Det gamla variabelnamnet

   fungerar dock fortfarande.

** Bytte namn från lyskom-minimum-triagle-size till

   lyskom-minimum-triangle-size.  Det gamla felstavade namnet

   ignoreras numera.

** Flera stavfel rättade.

                       News for lyskom.el 0.49

                       =======================

    Version 0.49 contains a number of major changes and enhancements.

    It is available from the following addresses:

      <URL:http://www.lysator.liu.se/lyskom/klienter/emacslisp/>

      <URL:ftp://ftp.lysator.liu.se/pub/lyskom/elisp-client/>

    The file is named lyskom-0.49.tar.gz, and a copy of this texts is

    available under the name NEWS-0.49 in the tar archive. There is

    also a zip file available at the same location for people using

    systems that do not understand tar files.

    If you find a bug in the LysKOM elisp client, please report it in

    our bugzilla at <URL:http://bugzilla.lysator.liu.se/> (product

    name lyskom-elisp-client). If you are unable to use bugzilla,

    please use M-x kom-bug-report. Note that reports filed using this

    method may inadvertently get lost. Reports submitted to bugzilla

    never get lost, no matter how much we would like that to happen to

    some of them.

    Everybody using Emacs 22 or later should upgrade to version 0.49.

* Compatibility

** Emacs 22.x introduced a non-backwards-compatible change and some

   bugs that severely impact performance of the elisp client. This

   version is compatible with the changes in Emacs 22.x.

** Emacs 23.x introduced non-backwards-compatible changes in menu

   handling and text decoding. This version is compatible with the

   changes in Emacs 23.x.

** Support for Emacs 21.x and earlier has been dropped. The client

   might still work with older Emacsen, but this has not been tested

   at all.

** You can probably use this client in XEmacs, but this has not been

   tested properly. Gnus must be installed for the client to work in

   XEmacs.

* New commands

** kom-review-more-comments: Extends the kom-review-comments to review

   an additional level of comments.

   Swedish name: Återse fler kommentarer [å a y]

   English name: Review more comments [r a M]

** kom-befriend: Adds a person to the kom-friends list.

   Swedish name: Lägg på vänner/bekanta-listan

   English name: Add to friend list

** kom-moronify: Adds a person to the kom-morons list.

   Swedish name: Lägg till idiot/knäppskalle-listan

   English name: Add to morons list

** kom-review-all-roots: Find all roots (texts that are not comments

   to anything) in a conference.

   Swedish name: Oläsmarkera alla urinlägg [å A]

   English name: Review all roots [r A]

** kom-unread-all-roots: Mark all roots in a conference as unread.

   Swedish name: Oläsmarkera alla [o A]

   English name: Unread all roots [u A]

** kom-review-first-roots: Review the first several roots in a

   conference.

   Swedish name: Återse första urinlägg [å F]

   English name: Review first roots [r F]

** kom-unread-first-roots: Mark the first several roots in a

   conference as unread.

   Swedish name: Oläsmarkera första urinlägg [o F]

   English name: Unread first roots [u F]

** kom-review-roots-by-to: Review roots by a specific user to a

   specific conference.

   Swedish name: Återse senaste urinlägg [å S]

   English name: Review last roots [r L]

** kom-unread-roots-by-to: Mark roots by a specific user to a specific

   conference as unread.

   Swedish name: Oläsmarkera senaste urinlägg [o S]

   English name: Unread last roots [r L]

** kom-delete-user-area: Delete the special text containing all saved

   settings. 

   Swedish name: Ta bort user-arean

   English name: Remove user area

** kom-move-comment: Move a comment from one text to another (useful

   if you commented the wrong text).

   Swedish name: Flytta kommentar [f k]

   English name: Move comment [h c]

** kom-view-url-in-text: Display the first URL in the current text of

   a LysKOM buffer. With prefix argument, view the Nth URL in the

   text.

   Swedish name: Visa URL [v u]

   English name: View URL [v u]

** New settings

** kom-ssh-general-errors: Regular expression for messages from ssh

   that indicate that ssh has failed. The default value should be

   suitable for the most common ssh clients.

** kom-ssh-forwarding-errors: Regular expression for messages from ssh

   that indicate that forwardning has failed. The default value should

   be suitable for the most common ssh clients.

** kom-respect-ancient-content-types: Set to non-nil in order to honor

   content types specified as they were in the bad old days.

** kom-read-related-first: Set to non-nil to try out a new reading

   mode where the client attempts to stop you from entering a thread

   in the middle. This mode sometimes results in having to re-read the

   same texts a lot, and sometimes results in the same text being

   shown over and over again without end.

* Changed commands

** kom-send-letter: Now always adds the sender's letterbox as a

   recipient, regardless of whether the sender is a member of the

   recipient or not.

** kom-copy-options attempts to avoid non-portable settings.

* Other changes worth noting

** The help function now offers help on individual commands. Help on

   individual commands is always shown in English.

** It is possible to completely customize highlighting of conference

   and person names via the kom-highlight-conferences variable. The

   default value of this variable highlights conference names as they

   were in previous versions of the client.

** Obsolete hook names have been removed.

** All non-text standard MIME types are handled without showing the

   contents of the texts.

** When writing, UTF-8 is used if possible, when ISO-8859-1 can't be

   used. When reading, US-ASCII texts are treated as ISO-8859-1, and

   Emacs build-in autodetection is used on texts that don't specify a

   charset.

** Use left mouse button to follow links in Emacs 22.1.

** Option to read commented text in other conferences before the text

   that comment them in the current conference.

** Lost connections are shown in all buffers.

** The client is now capable of reconnecting when the connection has

   been lost.

** Heuristics for automatic line breaking have been completely

   rewritten. The new version should be faster, better and easier to

   maintain.

ID        Summary

------------------------------------------------------------------------

212  WORK Man får läsa om inlägg som adderas till möten.

236  WONT SPC scrollar ibland inte

242       Brutna e-mail-headers hanteras fel

281       Hantering av importerade bilagor

297       Lägg till Opera i URL-öppnarlistan

407       Flyttade texter bör inte visas

438       lista nyheter - global för alla sessioner

440  WONT \200-\237 i vilkalista

443  WONT Buglistehanteringen städar för mycket ibland

673       Slutför prefixbyte på hookvariablerna

699  WONT lyskom-get-ancestors-of-text är rekursiv

751       Dålig ombrytning av punktade listor

766       Missvisande beskrivning om automatisk radbrytning

818       Automatisk komplettering vid uppkoppling

819       Varken x Addera mottagare eller C-c C-a C-m visar hela mottagarnamnet

1086      kom-add-recipient et al should move parent of footnoted text

1091      Sessionsavbrott är lätt att missa.

1118 WONT Svårt att bli av med text-properties som read-only

1130      Irriterande buffertbytebeteende

1138 WONT Olika semantik när man startar klient från kommandorad eller innifrån emacs

1143      Återse senaste urinläggen i ett visst möte.

1262      Flytta text bör inte ändra på mottagare som är brevlådor

1277      Tips om language-environment

1308      Nytt kommando: Flytta kommentar

1321      Ingen hantering av upptagna lokala portar i ssh-relay

1390 INVA Fel teckenmängd

1391      ?-kombo för att se vilka snabbkommandon som finns

1422      Addera vän under högerklicksmenyn på en person

1459      Krasch efter meddelanden vid inloggning

1501 WONT Svenska tecken i menyraden visas fel med terminal-emacsar i UTF-8 läge

1510      å y med å a k

1511      Host name comparisons should be case insensitive

1512      "Wrong type argument: keymapp, nil" in Xemacs

1519      Bli medlem i möte via kontextmeny misslyckas

1520      "Gå till mötet" saknas i kontextmenyn för brevlådan.

1524      Spara inställningar för LysKOM misslyckas.

1533      "Lista nyheter" ger färre antal olästa efter "lista ärenden".

1535      Defaultmottagare för Skicka brev

1536      Fel i kom-resurrect?

1542      kom-copy-options copies too much

1559 LATE Add MIME format support (such as HTML, through the w3 module)

1565 INVA Inte helt lättstartat på en standard-Windows med standard-emacs ...

1566      Felaktiga länkar på lyskom.el-webbsidan hos Lysator

1570      lyskom-map-keymap doesn't know about strings in keymaps

1589      åäö i text/x-kom-basic;charset=us-ascii

1602      Quoted charsets in the content-type aux-item not handled correctly

1608      Tidsstämpel i meddelanden om in-/utlogin

1619      Se diff sätter inte point innan den infogar diffen i kom-buffern

1620      Tidsstämpel i skickade meddelanden

1621      Omöjligt att få presence-meddelanden om sig själv

1631      Use mouse-1 to click on links

1632 INVA Use Emacs unification

1634      Fix multibyte menus

1635      Error in process sentinel at exit

1636      Anpassa klienten till emacs-unicode-2-grenen

1637      Use lyskom-indirect-assq for kom-highlight-conferences

1638      Klickläsmarkering fungerar inte längre

1639      Emacs 22.1 pos-visible-in-window-p and move-to-window-line are buggy

1641      Symbol's function definition is void: mm-find-mime-charset

1642 WORK auto-organize errs out when trying to kom-auto-organize-sub-recipient

1645      RPM target is broken

1646      fotnoter dupliceras

1651      Går inte att skicka in inlägg med XEmacs 21.5.x

1652 WORK Klienten går inte längre att bygga med XEmacs

1654      Klienten klarar inte att lägga till mottagare själv

1658      Stuck in rot-13-review mode

	1 .................................... The Format String

	2 .................................... Format Directives

	  2.1 ................................ Format nLetters

	  2.1 ................................ Format Letters

	  2.2 ................................ Format Arguments

	  2.3 ................................ Format Flags

        3 .................................... Formatting Functions

    string or the entire format string if processing is at the top

    level.

$ - Start an overlay. The argument is a property list containing the

    properties to set on the overlay. Overlays are only available when

    calling lyskom-format-insert and lyskom-format-insert-at-point.

    The extent of the overlay in the buffer is to the end of the

    current subformat string or the entire format string if processing

    is at the top level.

[ - Begin subformat. This directive does not use an argument.

] - Exit subformat. This directive does not use an argument.

;;;;;

;;;;; $Id$

;;;;; Copyright (C) 1991  Lysator Academic Computer Association.

;;;;;

;;;;; This file is part of the LysKOM server.

fnc.ent

var.ent

chp.xml

commands.xml

variables.xml

manual.ps

*.xml.inc

dummy.xml

editcmd.ent

EMACS=emacs-21.4

SRC=../../src

CHAPTERS=intro.xml \

	 texts.xml \

	 etiquette.xml \

	 commands.xml \

	 variables.xml \

         dummy.xml \

	 glossary.xml

GENFILES=fnc.ent var.ent editcmd.ent commands.xml variables.xml dummy.xml

INCFILES=$(CHAPTERS:%=%.inc)

# Generate the manual from DocBook XML using Jade wrappers

# I really don't know if the jw command is standard in installations

# of Jade, but it works fine in Debian/Gnu Linux. The path to the 

# stylesheet is also Linux (maybe Debian) specific.

manual.ps: $(INCFILES) $(GENFILES) manual.xml chp.xml

	jw -f docbook -d '/usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl#print' -b ps manual.xml

# These files are generated from the source code.

$(GENFILES): $(SRC)/lyskom.el

	$(EMACS) -batch -l $(SRC)/lyskom.el -l ./docgen.el -f lyskom-docgen

# This file is generated from the Makefile and contains references

# to all the chapters.

chp.xml: Makefile docgen.el

	echo > $@

	for i in $(INCFILES) ; do \

		echo "<!ENTITY $$i SYSTEM \"$$i\">" >> $@ ; \

	done

	echo "<!ENTITY chapters \"" \

	`echo $(INCFILES) | sed 's/\([-A-Za-z0-9.][-A-Za-z0-9.]*\)/\&\1; /g'` \

	"\">" >> $@

# Build lyskom.el if necessary

$(SRC)/lyskom.el:

	cd $(SRC) && make lyskom.el

clean:

	rm -f $(GENFILES)  $(INCFILES) chp.xml

# The .xml.inc files are the chapter files without the surrounding

# book element. Probably XSLT would be the Right Thing, but sed 

# gets the job done too

%.xml.inc: %.xml

	sed -e '/<book[ >]/,/<\/book>/! d' -e '/<book[ >]/ d' -e '/<\/book>/ d' < $< > $@

<?xml version='1.0' encoding='iso-8859-1' ?>

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

                      "docbook/dtd/xml/4.2/docbookx.dtd">

<book lang="en">

  <glossary>

    <title>Glossary</title>

    <glossdiv>

      <title>English</title>

      <glossentry id="gloss:text:en">

        <glossterm>text</glossterm>

        <glossdef>

          <para>See <xref linkend="chapter:texts"/> for details.</para>

        </glossdef>

      </glossentry>

      <glossentry>

        <glossterm id="gloss:comment:en">comment</glossterm>

        <glossdef>

          <para>See <xref linkend="texts:comments"/> for details.</para>

        </glossdef>

      </glossentry>

    </glossdiv>

    <glossdiv>

      <title>Svenska</title>

      <glossentry>

        <glossterm>text</glossterm>

        <glosssee otherterm="gloss:text:en">Se den engelska termen "text"</glosssee>

      </glossentry>

      <glossentry>

        <glossterm>kommentar</glossterm>

        <glosssee otherterm="gloss:comment:en">Se den engelska termen "comment"</glosssee>

      </glossentry>

    </glossdiv>

  </glossary>

</book>