whitespace.

[lyx.git] / lib / scripts / include_bib.py

diff --git a/lib/scripts/include_bib.py b/lib/scripts/include_bib.py
index 16156a502a7bfbd2f940bfa72a53071f48ed8ea6..54053558cee6bad8732bb6cf7d7336983d3b55c9 100644 (file)
--- a/lib/scripts/include_bib.py
+++ b/lib/scripts/include_bib.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 # file include_bib.py
@@ -9,6 +8,25 @@
 
 # Full author contact details are available in file CREDITS
 
+# This script is intended to include a BibTeX-generated biblography 
+# in a LaTeX file, as publishers often want. It can be run manually
+# on an exported LaTeX file, though it needs to be compiled first,
+# so the bbl file will exist.
+#
+# It should also be possible to create a LyX converter to run this
+# automatically. To set it up, create a format "ltxbbl"; make sure to 
+# check it as a document format. Then create a LaTeX-->ltxbbl converter, 
+# with the command:
+#   python -tt $$s/scripts/include_bib.py $$i $$o
+# and give it the flags:
+#   needaux,nice
+# You'll then have it in the export menu.
+# 
+# We do not activate this converter by default, because there are problems
+# when one tries to use multiple bibliographies.
+#
+# Please report any problems on the devel list.
+
 import sys, os
 
 class secbib: