]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Development.lyx
de.po
[lyx.git] / lib / doc / Development.lyx
index 34e39c2b55a115034fc0a1731bb56fa3018cccf0..82b2c5aef2aafb623c2179c0a389222e1ff2ce10 100644 (file)
@@ -1,4 +1,4 @@
-#LyX 2.3 created this file. For more info see http://www.lyx.org/
+#LyX 2.2 created this file. For more info see http://www.lyx.org/
 \lyxformat 508
 \begin_document
 \begin_header
@@ -458,30 +458,6 @@ src/version.h
 .
 \end_layout
 
-\begin_layout Enumerate
-Update the range of file formats in the array 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-format_relation
-\end_layout
-
-\end_inset
-
- in 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-lib/lyx2lyx/LyX.py
-\end_layout
-
-\end_inset
-
-.
-\end_layout
-
 \begin_layout Enumerate
 \begin_inset CommandInset label
 LatexCommand label
@@ -612,7 +588,8 @@ name "enu:updatefiles"
 
 \end_inset
 
-Update LyX's .lyx documentation files to the new format.
+Test your lyx2lyx code by updating LyX's .lyx documentation files to the
+ new format.
  The developer who makes the change knows best what changes to expect when
  inspecting the resulting diff.
  Because of this, you might be able to catch a bug in the lyx2lyx code that
@@ -686,7 +663,52 @@ gen_lfuns.py
 \end_inset
 
  before being converted to the latest format.
- Finally, commit using 
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ Only commit file format changes in the doc files if these files are using
+ the new feature of the new file format.
+ The reason is rule
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "enu:The-fileformat-of"
+
+\end_inset
+
+ of the documentation policies described in sec.
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Documentation-policies"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+Finally, commit using 
 \begin_inset Flex Code
 status collapsed
 
@@ -2005,13 +2027,17 @@ src/tex2lyx/test
 \end_layout
 
 \begin_layout Itemize
-In the appearing MSVC program right-click on the project 
+In the appearing MSVC program assure that you build the 
+\emph on
+release
+\emph default
+ version and then right-click on the project 
 \family sans
 updatetex2lyxtests
 \family default
  in the project explorer and chose 
 \family sans
-Create
+Build
 \family default
 .
 \end_layout
@@ -3401,9 +3427,17 @@ unreliable:nonstandard
 \begin_inset Quotes erd
 \end_inset
 
- or testing on a system withonly a subset of TeXLive installed), ignore
+ or testing on a system with only a subset of TeXLive installed), ignore
  the failure, ask for someone else to run the test, or install the missing
- ressources and try again.
+ resources and try again.
+\end_layout
+
+\begin_layout Itemize
+Check the log file Testing/Temporary/LastTest.log.
+ In case of latex-errors rerun the failing test with environment variable
+ 'LAX_DEBUG_LATEX' set to '1'.
+ This will include latex messages in LastTest.log, so it should be easier
+ to interpret the fail-reason.
 \end_layout
 
 \begin_layout Paragraph
@@ -5175,6 +5209,12 @@ No.
 \end_layout
 
 \begin_layout Section
+\begin_inset CommandInset label
+LatexCommand label
+name "sec:Documentation-policies"
+
+\end_inset
+
 Documentation policies
 \end_layout
 
@@ -5226,7 +5266,7 @@ PDF (pdflatex)
 \begin_inset Quotes erd
 \end_inset
 
- after your changes.
or the document's default output format after your changes.
 \end_layout
 
 \begin_layout Enumerate
@@ -5249,6 +5289,12 @@ reference "enu:If-you-are"
 \end_layout
 
 \begin_layout Enumerate
+\begin_inset CommandInset label
+LatexCommand label
+name "enu:The-fileformat-of"
+
+\end_inset
+
 The fileformat of a file must not be changed unless you document a new feature
  in LyX that requires a new fileformat.
  The reason for this rule is to keep it easy for the doc maintainers to