From 8fef2fd723be2bbeed3bb9043959ccf2afd4efa4 Mon Sep 17 00:00:00 2001
From: Richard Heck <rgheck@comcast.net>
Date: Thu, 21 Jan 2010 18:12:12 +0000
Subject: [PATCH] More XHTML documentation.

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@33131 a592a061-630c-0410-9148-cb99ea01b6c8
---
 lib/doc/Additional.lyx | 89 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 87 insertions(+), 2 deletions(-)

diff --git a/lib/doc/Additional.lyx b/lib/doc/Additional.lyx
index aa345fe2f3..bdf9321972 100644
--- a/lib/doc/Additional.lyx
+++ b/lib/doc/Additional.lyx
@@ -4379,7 +4379,7 @@ Another advantege is that, since these routines are internal to LyX, they
 \begin_inset Quotes eld
 \end_inset
 
-Chaper 1
+Chapter 1
 \begin_inset Quotes erd
 \end_inset
 
@@ -4483,7 +4483,7 @@ The remainder of this chapter contains more detailed information on XHTML
 status open
 
 \begin_layout Plain Layout
-This is very imcomplete at this point!
+This is very incomplete at this point!
 \end_layout
 
 \end_inset
@@ -4491,6 +4491,91 @@ This is very imcomplete at this point!
 
 \end_layout
 
+\begin_layout Section
+Bibliography and Citations
+\end_layout
+
+\begin_layout Standard
+XHTML output fully supports bibliographies and citations.
+ 
+\end_layout
+
+\begin_layout Standard
+Citation labels are generated by exactly the same machinery that generates
+ LyX's on-screen labels, so the labels will look in the output much as they
+ do in LyX, though better.
+ If you are using numerical citations, then LyX will output numerical labels,
+ such as [1] or [17], rather than simply showing the citation key in square
+ brackets, as it does on-screen.
+ If you are using author-year citations, then LyX will add lowercase letters
+ to the years, just as BibTeX does, if it finds more than one citation for
+ a given author-year combination.
+ The labels will be printed with the bibliography entries.
+ Note that there is, at present, no way to customize the appearance of the
+ labels, for example, to choose between square brackets and parentheses.
+\end_layout
+
+\begin_layout Standard
+Bibliography output is handled by the same machinery that handles the presentati
+on of reference information in the citation dialog, so you will see in the
+ XHTML output pretty much what you would see if you were to look at a given
+ entry in the citation dialog.
+ Unfortunately, the formatting of bibliography entries, too, is at present
+ not customizable, and it is fairly primitive, though this should change
+ shortly.
+ 
+\end_layout
+
+\begin_layout Standard
+The other significant defect is that cross-referenced information is printed
+ with every entry with which it is associated.
+ So you can see things like this:
+\end_layout
+
+\begin_layout Quote
+Jason Stanley, 
+\begin_inset Quotes eld
+\end_inset
+
+Context and Logical Form
+\begin_inset Quotes erd
+\end_inset
+
+, in 
+\emph on
+Language in Context: Selected Essays
+\emph default
+ (Oxford: Oxford University Press, 2007), pp.
+ 30--68.
+\end_layout
+
+\begin_layout Quote
+Jason Stanley, 
+\begin_inset Quotes eld
+\end_inset
+
+Semantics in Context
+\begin_inset Quotes erd
+\end_inset
+
+, in 
+\emph on
+Language in Context: Selected Essays
+\emph default
+ (Oxford: Oxford University Press, 2007), pp.
+ 201--30.
+\end_layout
+
+\begin_layout Standard
+Again, this should be fixed before long.
+\end_layout
+
+\begin_layout Standard
+There is no support at present for sectioned bibliographies.
+ If you have multiple bibliographies, then LyX will print the same bibliography
+ over and over.
+\end_layout
+
 \begin_layout Section
 Indexes
 \end_layout
-- 
2.39.2