Vers=
ion: 0.3.0
\ No newline at end of file
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">Twisted Documentation=
: Twisted Lore examples
The Lore Documentation System, out of the bo=
x, is
specialized for documenting Twisted. Its markup includes CSS classes for
Python, HTML, filenames, and other Twisted-focused categories. But don't
think this means Lore can't be used for other documentation tasks! Lore is
@@ -233,4 +233,4 @@
=20
classMyChapterLatexSpitter(MySpitterMixi=
n, latex.ChapterLatexSpitter):
pass
-
Version: 0.3.0
\ No newline at end of file
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">Twisted Documentation=
: Twisted Lore Documentation
Lor=
e documents are a special subset of XHTML documents. They use specific
subset of XHTML, together with custom classes, to allow a wide variety of
document elements, including some Python-specific ones. Lore documents, in
particular, are well-formed XML documents. XML can be written using a wide
@@ -133,4 +133,4 @@
This will generate compiler-style (file:line:column:message) warnin=
gs.
It is possible to integrate these warnings into a smart editor such as
EMACS, but it has not been done yet.
The --=
help prints out a usage message to standard output.
+
-p, --plain
Use non-flashy=
progress bar - one file per line.
+
-n, --null
Do not report =
progress at all.
+
-l, --linkrel
Where non-document links sh=
ould be relative to.
+
-d, --docsdir
Where to look for .=
html files if no files are given.
+
-i, --input
Input format. New input forma=
ts can be dynamically registered. Lore itself
+comes with lore (the standard format), mlore (allows LaTeX equ=
ations)
+and man (man page format). If the input format is not registered as a=
plugin,
+a module of the named input will be searched. For example,=20
+--i twisted.lore.defaultis equivalent to using the default=
Lore input.
+
-o, --output
Output format. Available out=
put formats depend on the input. For the core
+formats, lore and mlore support html, latex and lint, while man allows
+lore.
+
--config
Add input/output-specific information.=20
+HTML output allows for 'ext=3D<extension>',
+'template=3D<template>' and 'baseurl=3D<format string for API URLs&=
gt;'. LaTeX
+output allows for 'section' or 'chapter' in Lore, and nothing in Math-Lore. =
+Lore output allows for 'ext=3D<extension>'. Lint output allows nothing.
+Note that disallowed --config options are merely ignored, and do
+not cause errors.
+
DESCRIPTION
If no files are g=
iven, all *.html documents in docsdir are processed.
+
Version: 8.0.0
\ No newline at end of file
diff -urN --exclude=3DCVS --exclude=3D.cvsignore --exclude=3D.svn --exclude=
=3D.svnignore old/TwistedLore-0.3.0/LICENSE new/TwistedLore-8.0.0/LICENSE
--- old/TwistedLore-0.3.0/LICENSE 2006-06-03 22:59:55.000000000 +0200
+++ new/TwistedLore-8.0.0/LICENSE 2008-03-25 17:06:58.000000000 +0100
@@ -1,4 +1,4 @@
-Copyright (c) 2001-2006
+Copyright (c) 2001-2008
Allen Short
Andrew Bennetts
Apple Computer, Inc.
@@ -15,7 +15,7 @@
Jonathan Lange
Jonathan D. Simms
Jp Calderone
-J=EF=BF=BDrgen Hermann
+J=C3=BCrgen Hermann
Kevin Turner
Mary Gardiner
Matthew Lefkowitz
@@ -26,6 +26,10 @@
Ralph Meijer
Sean Riley
Travis B. Hartwell
+Thomas Herve
+Eyal Lotem
+Antoine Pitrou
+Andy Gayton
=20
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
diff -urN --exclude=3DCVS --exclude=3D.cvsignore --exclude=3D.svn --exclude=
=3D.svnignore old/TwistedLore-0.3.0/NEWS new/TwistedLore-8.0.0/NEWS
--- old/TwistedLore-0.3.0/NEWS 2007-01-06 23:24:26.000000000 +0100
+++ new/TwistedLore-8.0.0/NEWS 2008-03-25 17:18:51.000000000 +0100
@@ -1,3 +1,20 @@
+8.0.0 (2008-03-17)
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+Fixes
+-----
+ - Change twisted.lore.tree.setIndexLin so that it removes node with index-l=
ink
+ class when the specified index filename is None. (#812)
+ - Fix the conversion of the list of options in man pages to Lore format.
+ (#3017)
+ - Fix conch man pages generation. (#3075)
+ - Fix management of the interactive command tag in man2lore. (#3076)
+
+Misc
+----
+ - #2847
+
+
0.3.0 (2007-01-06)
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
diff -urN --exclude=3DCVS --exclude=3D.cvsignore --exclude=3D.svn --exclude=
=3D.svnignore old/TwistedLore-0.3.0/README new/TwistedLore-8.0.0/README
--- old/TwistedLore-0.3.0/README 2007-01-06 23:21:41.000000000 +0100
+++ new/TwistedLore-8.0.0/README 2008-03-25 17:13:14.000000000 +0100
@@ -1,3 +1,3 @@
-Twisted Lore 0.3.0
+Twisted Lore 8.0.0
=20
Twisted Lore depends on Twisted and Twisted Web.
diff -urN --exclude=3DCVS --exclude=3D.cvsignore --exclude=3D.svn --exclude=
=3D.svnignore old/TwistedLore-0.3.0/twisted/lore/man2lore.py new/TwistedLore-=
8.0.0/twisted/lore/man2lore.py
--- old/TwistedLore-0.3.0/twisted/lore/man2lore.py 2004-08-25 10:36:30.000000=
000 +0200
+++ new/TwistedLore-8.0.0/twisted/lore/man2lore.py 2008-03-17 14:20:22.000000=
000 +0100
@@ -1,28 +1,51 @@
-# Copyright (c) 2001-2004 Twisted Matrix Laboratories.
+# -*- test-case-name: twisted.lore.test.test_man2lore -*-
+# Copyright (c) 2001-2008 Twisted Matrix Laboratories.
# See LICENSE for details.
=20
-#
-"""man2lore: Converts man page source (i.e. groff) into lore-compatible html.
+
+"""
+man2lore: Converts man page source (i.e. groff) into lore-compatible html.
=20
This is nasty and hackish (and doesn't support lots of real groff), but is g=
ood
enough for converting fairly simple man pages.
"""
-from __future__ import nested_scopes
=20
import re, os
+
quoteRE =3D re.compile('"(.*?)"')
=20
+
+
def escape(text):
text =3D text.replace('<', '<').replace('>', '>')
text =3D quoteRE.sub('\\1', text)
return text
=20
+
+
def stripQuotes(s):
if s[0] =3D=3D s[-1] =3D=3D '"':
s =3D s[1:-1]
return s
=20
-class ManConverter:
+
+
+class ManConverter(object):
+ """
+ Convert a man page to the Lore format.
+
+ @ivar tp: State variable for handling text inside a C{TP} token. It can
+ take values from 0 to 3:
+ - 0: when outside of a C{TP} token.
+ - 1: once a C{TP} token has been encountered. If the previous va=
lue
+ was 0, a definition list is started. Then, at the first line of
+ text, a definition term is started.
+ - 2: when the first line after the C{TP} token has been handled.
+ The definition term is closed, and a definition is started with
+ the next line of text.
+ - 3: when the first line as definition data has been handled.
+ @type tp: C{int}
+ """
state =3D 'regular'
name =3D None
tp =3D 0
@@ -43,6 +66,7 @@
self.closeTags()
self.write('\n