aboutsummaryrefslogtreecommitdiffstats
path: root/documentation/lcd4linux
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/lcd4linux')
-rw-r--r--documentation/lcd4linux/Makefile59
-rw-r--r--documentation/lcd4linux/bug_report.xml32
-rw-r--r--documentation/lcd4linux/example.xml50
-rw-r--r--documentation/lcd4linux/index.xml17
-rw-r--r--documentation/lcd4linux/write_doc.xml102
5 files changed, 0 insertions, 260 deletions
diff --git a/documentation/lcd4linux/Makefile b/documentation/lcd4linux/Makefile
deleted file mode 100644
index 2519f22..0000000
--- a/documentation/lcd4linux/Makefile
+++ /dev/null
@@ -1,59 +0,0 @@
-# Path
-DIR = $(notdir $(PWD))
-OUTPUT = ../HTML
-
-ifeq "$(DIR)" "lcd4linux"
- DIR =
-endif
-
-ifeq "$(DIR)" ""
- XSLTPROC = xsltproc
-else
- XSLTPROC = xsltproc --stringparam class $(DIR) --stringparam root "../"
-endif
-
-XMLVALID = xmllint --noout --valid
-
-NAMES=$(shell find . -name "*.xml" -exec basename {} .xml \;)
-
-html: $(patsubst %.xml,%.html,$(wildcard *.xml))
-html-forced: $(patsubst %.xml,%.html-forced,$(wildcard *.xml))
-
-%.html: %.xml %.xml-check output
- $(XSLTPROC) $< > $(OUTPUT)/$(DIR)/$@
-
-%.html-forced: %.xml output
- $(XSLTPROC) $< > $(OUTPUT)/$(DIR)/$(patsubst %.xml,%.html,$<)
-
-check: $(patsubst %.xml, %.xml-check, $(wildcard *.xml))
-
-%.xml-check: %.xml
- @echo "*** Validation of $<"
- $(XMLVALID) $<
-
-output:
- test -d $(OUTPUT) || `mkdir $(OUTPUT); cp ../data/doc.css $(OUTPUT); cp -R ../data/images $(OUTPUT)`
- test -d $(OUTPUT)/$(DIR) || mkdir $(OUTPUT)/$(DIR)
-
-clean:
- rm -f $(OUTPUT)/$(DIR)/*.html
-
-clean-bak:
- rm -f *~ *.bak
-
-help:
- @echo -e ""
- @echo -e "Usage :"
- @echo -e "-------"
- @echo -e "make or make html : builds all possible html pages from xml files"
- @echo -e "make %.html : builds the %.html page from %.xml"
- @echo -e ""
- @echo -e "make html-forced : builds all possible html pages from xml files (no validity check)"
- @echo -e "make %.html-forced : builds the %.html page from %.xml (no validity check)"
- @echo -e ""
- @echo -e "make check : checks the validity of all possible xml files"
- @echo -e "make %.xml-check : checks the validity of %.xml"
- @echo -e ""
- @echo -e "make clean : deletes all generated html pages"
- @echo -e "make clean-bak : deletes *~ and *.bak files"
- @echo -e ""
diff --git a/documentation/lcd4linux/bug_report.xml b/documentation/lcd4linux/bug_report.xml
deleted file mode 100644
index 49bf743..0000000
--- a/documentation/lcd4linux/bug_report.xml
+++ /dev/null
@@ -1,32 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
-<?xml-stylesheet type="text/xsl" href="../xsl/doc.xsl"?>
-<!DOCTYPE doc SYSTEM "../dtd/doc.dtd">
-<doc>
-<head>
- <title>How to report bugs or get support</title>
- <ref>bug_report</ref>
- <links>
- <link ref="contact"/>
- </links>
-</head>
-<body>
-You've checked twice your configuration, but &l4l; keeps complaining, prints horrible things on your display or even crashes. What to do ?
-
-<h2>Configuration problems and minor bugs</h2>
-<ul>
-<li>Your display doesn't want to work, prints strange things or keeps blank ?</li>
-<li>You can't get a plugin to work, there are ???? or **** where you wanted to display the temperature ?</li>
-<li>You noticed a strange behavior from &l4l; or a plugin ?</li>
-</ul>
-You should contact the lcd4linux-users maillist, and post a detailled report containing at least :
-<ul>
-<li>the &l4l; version you use.</li>
-<li>a description of what happens</li>
-<li>if relevant, a description of your display (especially for HD44780-based displays)</li>
-<li>a log of &l4l; output ( <tt>lcd4linux -vvv > log</tt> )</li>
-<li>a copy of your lcd4linux.conf file</li>
-</ul>
-<note>If you use some plugins (mysql, mail, ...), lcd4linux.conf may contain passwords and other private information. For your privacy, we recommend you to replace these information with ***** before attaching your configuration file</note>
-
-</body>
-</doc>
diff --git a/documentation/lcd4linux/example.xml b/documentation/lcd4linux/example.xml
deleted file mode 100644
index 63702e0..0000000
--- a/documentation/lcd4linux/example.xml
+++ /dev/null
@@ -1,50 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
-<?xml-stylesheet type="text/xsl" href="../xsl/doc.xsl"?>
-<!DOCTYPE doc SYSTEM "../dtd/doc.dtd">
-<doc>
-<head>
- <title>The title of the page The title of the page</title>
- <version>0.1</version>
- <ref>doc_example</ref>
- <links>
- <link ref="i2c_sensors"/>
- <link url="http://lcd4linux.sf.net"/>
- <link url="http://lcd4linux.sf.net">SourceForge</link>
- </links>
- <history>
- <revision version="0.1" by="Xavier">
- The first, and only version ever ;)
- </revision>
- <revision version="0.0" by="Xavier">
- TEST
- </revision>
- </history>
- <state finished="true" proofread="true"/>
-</head>
-<body>
-<h2>This is the text of the page, we can use xhtml tags here and there are some helpers : </h2>
-<cmd>&lt;cmd&gt; Will be used to indicate <tt>console commands</tt>, or other things</cmd>
-<conf>&lt;conf&gt; Is to format lcd4linux.conf examples</conf>
-<note>&lt;note&gt; Will display a div with the message, to add a tip, or an explanation</note>
-<warn>&lt;warn&gt; Will work just as &lt;note&gt;, but for more important messages</warn>
-<new date="01/01/01" title="test new">&lt;new&gt; is to display boxes with news, for the main page or, as an example for displays/plugins pages to show news in the features</new> <br />
-
-<link ref="plugin_i2c_sensors"/>
-
-There will be other helpers : &lt;image&gt;, &lt;link&gt;, &lt;table&gt; ...<br />
-
-If you look at the sources of this page, there are a lot of information in the head. They will be used for internal processing, and some will be displayed (for example &lt;links&gt; will define links to be put in a &apos;See also&apos; box, with links to related articles, websites, ...<br />
-
-We&apos;ll use &apos;standard&apos; xhtml tags &lt;br /&gt; <b>&lt;b&gt;</b> <i>&lt;i&gt;</i> <tt>&lt;tt&gt;</tt> <small>&lt;small&gt;</small> <big>&lt;big&gt;</big> and others, not really proceced by xslt.
- <h2>&lt;h2&gt;</h2> <h3>&lt;h3&gt;</h3> <h4>&lt;h4&gt;</h4> <h5>&lt;h5&gt;</h5> <h6>&lt;h6&gt;</h6>
-
- <h2>test</h2>
- <h3>one</h3>
- <h3>two</h3>
- <h3>three</h3>
- <h2>AAAA</h2>
- <h3>one</h3>
- <h3>two</h3>
- <h3>three</h3>
-</body>
-</doc>
diff --git a/documentation/lcd4linux/index.xml b/documentation/lcd4linux/index.xml
deleted file mode 100644
index 93f75eb..0000000
--- a/documentation/lcd4linux/index.xml
+++ /dev/null
@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
-<?xml-stylesheet type="text/xsl" href="../xsl/doc.xsl"?>
-<!DOCTYPE doc SYSTEM "../dtd/doc.dtd">
-<doc>
-<head>
- <title>&L4L; documentation index</title>
- <ref>index</ref>
-</head>
-<body>
-<h2>&L4L;</h2>
-<index/>
-<h2><a href="drivers/index.html">Drivers</a></h2>
-<index class="drivers"/>
-<h2><a href="plugins/index.html">Plugins</a></h2>
-<index class="plugins"/>
-</body>
-</doc>
diff --git a/documentation/lcd4linux/write_doc.xml b/documentation/lcd4linux/write_doc.xml
deleted file mode 100644
index b8d243d..0000000
--- a/documentation/lcd4linux/write_doc.xml
+++ /dev/null
@@ -1,102 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
-<?xml-stylesheet type="text/xsl" href="../xsl/doc.xsl"?>
-<!DOCTYPE doc SYSTEM "../dtd/doc.dtd">
-<doc>
-<head>
- <title>How to write documentation for &l4l; ?</title>
- <ref>write_doc</ref>
-<!-- <links>
- <link ref="i2c_sensors"/>
- </links>-->
-</head>
-<body>
-<h2>Overview</h2>
-<p>The &l4l; documentation is composed of XML files which are processed with XSL stylesheets to produce XHTML files.
-There these XML files are writen in a syntax similar to the HTML syntax, plus some helpers.</p>
-<p>The whole documentation is generated through a make system, which uses <tt>xmllint</tt> to check the validy of the xml files and <tt>xsltproc</tt> to process them and generate the XHTML pages. <i>These two programs are mandatory</i></p>
-
-<h2>The syntax</h2>
-A doc page looks like this :
-<conf>&lt;?xml version="1.0" encoding="UTF-8" standalone="no" ?&gt;
-&lt;?xml-stylesheet type="text/xsl" href="../xsl/doc.xsl"?&gt;
-&lt;!DOCTYPE doc SYSTEM "../dtd/doc.dtd"&gt;
-&lt;doc&gt;
-&lt;head&gt;
- &lt;title&gt;How to write documentation for &l4l; ?&lt;/title&gt;
- &lt;ref&gt;write_doc&lt;/ref&gt;
- &lt;links&gt;
- &lt;link ref="http://lcd4linux.sf.net"/&gt;
- &lt;/links&gt;
-&lt;/head&gt;
-&lt;body&gt;
-...
-&lt;/body&gt;
-&lt;/doc&gt;
-</conf>
-
-<li>The three first lines are the preambule of the file, don't touch them.</li>
-<li>The root of the document is <tt>&lt;doc&gt;</tt>, it's the equivalent of &lt;html&gt;.</li>
-<li>Then, there's a <tt>&lt;head&gt;</tt> node, containing the information about the page. See later for the childs.</li>
-<li>The core of the doc is the &lt;body&gt; node, like in HTML, containing the content.</li>
-
-<h3>The &lt;head&gt;</h3>
-The head contains some information about the document :
-<li>&lt;title&gt; is the title of the document, which will be displayed as a &lt;h1&gt;</li>
-<li>&lt;ref&gt; is a unique reference for the document, which is assumed to be the same as in <i>references.xml</i> (we'll discuss later about this file)</li>
-<li>&lt;links&gt; is the section responsible of the "See Alo" box, containing links to other help pages, or to urls. It can contain several &lt;link&gt; elements, whose syntax is explained in the next part.</li>
-<li>There may be other elements, but we'll only use these ones for now.</li>
-
-<h3>The helpers</h3>
-You can use a lot of helpers in the body :
-<li>&lt;link&gt; is a helper to create links. It is used with one of these two arguments :
-<ul>
-<li><tt>&lt;link ref="xxx"/&gt;</tt> will create a link to the documentation page associated with this reference (defined in <i>references.xml</i>)</li>
-<li><tt>&lt;link url="http://..."/&gt;</tt> will create a link to the url</li>
-</ul>
-Note that if you don't provide a text, the text of the link will be the label of the reference or the url. You can specify a text writing <tt>&lt;link url="http://..."&gt;TEXT&lt;/link&gt;</tt>
-</li>
-<warn>As this is XML, you <b>must</b> close all the tags you open, or use self-closing tags for empty ones :<br/>For example, you have to write <tt>&lt;br/&gt;</tt> but not <tt>&lt;br&gt;.</tt></warn>
-
-<li>&lt;cmd&gt; Opens a box with write text on black background, used to indicate something's happening in a console (compilation, logs, ...). The text is in "pre" mode, so spaces and newlines are kept, no need of &amp;nbsp; or &lt;br/&gt;, <b>But beware of &lt; and &gt;</b> (you must replace them with &amp;lt; and &amp;gt;)</li>
-<cmd>xav:~$ echo "An example of &lt;cmd&gt; box"
-An example of &lt;cmd&gt; box
-xav:~$
-</cmd>
-<li>&lt;conf&gt; works like &lt;cmd&gt; but with black text on grey background, to print lcd4linux.conf examples.</li>
-<conf>Widget Lightning {
- class 'icon'
- speed 100
- visible cpu('busy', 500)-50
- bitmap {
- row1 '...***'
- row2 '..***.'
- row3 '.***..'
- row4 '.****.'
- row5 '..**..'
- row6 '.**...'
- row7 '**....'
- row8 '*.....'
- }
-}</conf>
-<li>&lt;note&gt; is to display a box with a small icon, to point out a detail, or an advice</li>
-<note>To dry a wet cat, don't put it in a microwave ;)</note>
-<li>&lt;warn&gt; works like &lt;note&gt; but with a red exclamation mark and a red border, to display warnings. In general, use a note for a detail or an advice and warn to point configuration problems, hardware hazards, or other happy things ;)</li>
-<warn>We're not responsible for damages caused to your microwave if you don't read the above note !</warn>
-<li>&lt;index&gt; is a cool thing. It displays the list of pages of a specified class. It's used to display indexes. For example &lt;index class="drivers"/&gt; will display a list of all pages about drivers. If there's no class specified, it'll parse the list of pages of the "lcd4linux" class.</li>
-<li>&lt;new&gt; is in the DTD, but is not yet implemented :/</li>
-<li>You can use any other XHTML-valid tag. The most used should be : &lt;br/&gt; &lt;h2&gt; &lt;h3&gt; &lt;li&gt; &lt;b&gt; &lt;i&gt; &lt;tt&gt; ...</li>
-
-<h3>references.xml</h3>
-There's a file in <tt>data/</tt> called <tt>references.xml</tt>. It isn't processed directly, but is used to parse links and indexes. It's syntax is quite straightforward, so I won't explain it.<br/>
-You must add a new entry in it for each page you write so that other pages can have links to it and index it.
-<note>A null &lt;class/&gt; attribute corresponds to the lcd4linux class. It's not a bug, it's a feature, used to make links (the lcd4linux class is in the root of the documentation)</note>
-
-<h2>The compilation system</h2>
-The documentation is compiled with a Makefile build system. There's a toplevel Makefile which calls the apropriate targets in each subdirs which contains xml files (for the moment, <tt>lcd4linux</tt>, <tt>drivers</tt> and <tt>plugins</tt>). In these subdirs, the Makefile is a link to <tt>Makefile.generic</tt>.<br/>
-To compile the documentation, just type make at the toplevel, and look in the <tt>HTML</tt> folder. Type make help for help ;)
-<warn>Two programs are mandatory to build the documentation :
-<ul><li><tt>xmllint</tt> from libxml2 is used to validate the xml pages to be processed. It's in the debian package <tt>libxml2</tt></li>
-<li><tt>xsltproc</tt> from libxslt processes the xml files to generate the html pages. It's in the libxslt tarballs or in the <tt>xsltproc</tt> debian package</li></ul>
-</warn>
-</body>
-</doc>