Commit 6d81a0f7 authored by David Byers's avatar David Byers
Browse files

Documentation updates

parent 133d8c78
This diff is collapsed.
<!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" -->
......@@ -1843,11 +1844,11 @@
<title>Uppskjuta läsning - e</title>
<para>
<indexterm id="kom-set-unread-1">
<indexterm id="kom-postpone-1">
<primary>Läsning</primary>
<secondary>Uppskjuta läsning</secondary>
</indexterm>
<indexterm id="kom-set-unread-2">
<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
......@@ -1877,6 +1878,9 @@
</comment>
</sect2>
<sect2>
<title>Unfinished stuff</title>
<para>
Läsa inlägg
Vanlig läsning
Endast läsa senaste
......@@ -1884,7 +1888,8 @@
Återse
Filtrering
Markering
</para>
</sect2>
</sect1>
<sect1>
......@@ -2047,8 +2052,8 @@ upp fel. Det tycker jag
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 <URL:http://www.cis.ohio
-state.edu/cgi-bin/rfc/rfc1738.html>. Då kan man till och med bryta
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/-----------------------------
......@@ -2056,6 +2061,6 @@ URLen
</para>
</chapter>
&genindex.sgm;
<!--&genindex.sgm;-->
</book>
<?xml version='1.0' encoding='iso-8859-1' ?>
<!DOCTYPE book SYSTEM "manual.dtd">
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"docbook/dtd/xml/4.2/docbookx.dtd" [
<!ENTITY % fnc SYSTEM "fnc.ent">
<!ENTITY % var SYSTEM "var.ent">
%fnc; <!-- LysKOM functions -->
%var; <!-- LysKOM variables -->
]>
<book lang="en">
<chapter>
......@@ -188,7 +195,7 @@
for manipulating server FAQs; these can only be used by
users with administrative rights to the LysKOM server.
</para>
<para>
There are a number of settings that affect FAQs.
&var:kom-auto-list-faqs; controls automatic listing of FAQs
......
(defun lyskom-news-document-command ()
(interactive)
(let* ((cn (intern (thing-at-point 'symbol)))
(doc (documentation cn))
(sn (let ((lyskom-language 'sv)) (lyskom-command-name cn)))
(en (let ((lyskom-language 'en)) (lyskom-command-name cn)))
(sb (mapcar 'key-description (where-is-internal cn lyskom-sv-mode-map)))
(eb (mapcar 'key-description (where-is-internal cn lyskom-en-mode-map)))
(fill-prefix " "))
(lyskom-insert-at-point (lyskom-format "\
** %#2s: %[%#1F%#3s%]
Swedish name: %#4s%#6?b%[ [%#6s]%]%[%]
English name: %#5s%#7?b%[ [%#7s]%]%[%]
"
72 cn (or doc "No documentation") sn en
(and sb (mapconcat 'identity sb ", "))
(and eb (mapconcat 'identity eb ", "))))))
......@@ -34,8 +34,18 @@ The syntax of all format directives is
%[pad-length]#[arg-no][flags][format-letter][letter-options]
pad-length is the length of the resulting string. If it is negative,
is will be left-justified in the length, otherwise
right-justified. This field is optional.
is will be left-justified in the length, otherwise right-justified.
This field is optional. All format directives accept a colon followed
by an arbitrary character before the argument number (e.g.
"%10:-#1s"). The character will be used as the pad character.
When inserting floats (%f), pad-length can be of the form
[total-length].[min-fraction-length].[max-fraction-length], in which
case between min-fraction-length and max-fraction-length decimal
places are shown, and the total size of the formatted string is
total-length. Standard modifiers, such as - and = still apply. Note
that max-fraction-length is optional together with its preceding
period.
arg-no is the argument number from the argument list to insert, and
must be prefixed by a hash mark when it exists. This field is
......@@ -65,6 +75,12 @@ x - Insert an integer in hexadecimal format.
c - Interpret and insert an integer as a single character.
f - Insert a float (like %f in regular format)
g - Insert a float (like %g in regular format)
e - Insert a float (like %e in regular format)
@ - The argument must be a valid text property list, and will be
inserted into the buffer at the point of this directive provided
one of the lyskom-format-insert functions was called. The extent
......@@ -109,6 +125,13 @@ n - The argument must be an integer or a text-stat. The integer or
r - The argument is a string and will be formatted as a subject line.
F - Fill the region that this directive is active for (i.e. the
current subformat or to the end of the string). The argument is
the value of fill-column to use.
l - The argument is a string or character that is used to fill out the
entire pad-length.
? - A conditional. The type of argument depends on letter-options.
Currently implemented letter-options are "d" for one-or-more, "b"
for booleans and "z" for zero/nonzero.
......@@ -154,6 +177,7 @@ format letter). This means downcase the result.
2.4 Conditionals
The "?" format letter introduces a conditional in the format string.
......@@ -183,11 +207,14 @@ b - Boolean. The first subformat is chosen if the argument is non-nil
variable "answer" as "yes" or "no" for t and nil using
(lyskom-format "%#1?b%[yes%]%[no%]" answer).
z - Zero. The first subformat is chosen if the argument is zero and
the second if the argument is nonzero. You could format a conf-no
z - Zero. The first subformat is chosen if the argument is nonzero and
the second if the argument is zero. You could format a conf-no
variable as a "does not exist" or the conference name using
(lyskom-format "%#1?z%[does not exist%]%[%#1M%]")
+ - Non-negative. The first subformat is chosen if the argument is
zero or more; the second is chosen if it is negative.
3. FORMATTING FUNCTIONS
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment