From 5dc2ef13b84ecef2215ab6b18700d4a3ff0d8488 Mon Sep 17 00:00:00 2001 From: Juergen Spitzmueller Date: Fri, 28 Jul 2017 11:15:23 +0200 Subject: [PATCH] Some updates in the Literate Programming section I did while translating. --- lib/doc/Additional.lyx | 165 +++++++++++++++++++++++++++++++++++++---- 1 file changed, 150 insertions(+), 15 deletions(-) diff --git a/lib/doc/Additional.lyx b/lib/doc/Additional.lyx index 7e6e576bfc..69f1ca52b0 100644 --- a/lib/doc/Additional.lyx +++ b/lib/doc/Additional.lyx @@ -6301,6 +6301,17 @@ push \begin_layout Section Starting the \SpecialChar LyX Server +\change_inserted -712698321 1501232552 + +\begin_inset CommandInset label +LatexCommand label +name "sec:Starting-the-Server" + +\end_inset + + +\change_unchanged + \end_layout \begin_layout Standard @@ -24236,7 +24247,7 @@ The complete Literate Programming FAQ can be found at: \begin_layout Quote Literate Programming FAQ \begin_inset Flex URL -status collapsed +status open \begin_layout Plain Layout @@ -24280,8 +24291,31 @@ e. \begin_inset space \space{} \end_inset -it is easy to plug in new filters and to perform special processing that - you may need. +it is easy to plug in new filters +\change_inserted -712698321 1501229014 + +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1501229136 + +\emph on +Filters +\emph default +are programs that read a given data stream and output a manipulated data + stream. + That way, a WEB file (consisting of literate code) can be turned into a + file consisting only of C program code or \SpecialChar LaTeX + code. +\end_layout + +\end_inset + + +\change_unchanged + and to perform special processing that you may need. \end_layout @@ -24361,8 +24395,18 @@ Using the noweb module \begin_layout Standard If you have installed Noweb and \SpecialChar LyX successfully, whenever you open a new document, - after you have chosen its document class, use the Document->Settings menu - to add the + after you have chosen its document class, use the +\family sans +Document +\change_deleted -712698321 1501229457 +-> +\change_inserted -712698321 1501229457 +\SpecialChar menuseparator + +\change_unchanged +Settings +\family default + menu to add the \begin_inset Quotes eld \end_inset @@ -24396,7 +24440,13 @@ Typing code in \begin_layout Standard \SpecialChar LyX - enables you to write code with a layout named + enables you to write code with a +\change_deleted -712698321 1501229783 +layout +\change_inserted -712698321 1501229785 +custom inset +\change_unchanged + named \begin_inset Flex Noun status collapsed @@ -24456,7 +24506,13 @@ Chunk \end_inset -, that works like a normal paragraph but has a free spacing capability. +, that works like a normal +\change_deleted -712698321 1501229871 +paragraph +\change_inserted -712698321 1501229873 +text inset +\change_unchanged + but has a free spacing capability. \end_layout \begin_layout Standard @@ -24568,7 +24624,13 @@ Chunk \end_inset - layout that, by itself, takes care of the business. + +\change_deleted -712698321 1501230025 +layout +\change_inserted -712698321 1501230027 +inset +\change_unchanged +that, by itself, takes care of the business. \end_layout \begin_layout Enumerate @@ -24682,6 +24744,13 @@ Converter \end_inset setting, should be set to +\change_inserted -712698321 1501230220 + +\end_layout + +\begin_layout LyX-Code + +\change_deleted -712698321 1501230232 \begin_inset Newline newline \end_inset @@ -24690,10 +24759,14 @@ Converter \end_inset +\change_unchanged + \family typewriter build-script $$i \family default $$r +\change_deleted -712698321 1501230236 + \begin_inset Quotes erd \end_inset @@ -24701,6 +24774,12 @@ build-script $$i \begin_inset Newline newline \end_inset + +\change_inserted -712698321 1501230224 + +\end_layout + +\begin_layout Standard This basically means that \SpecialChar LyX will call \begin_inset Quotes eld @@ -24730,42 +24809,54 @@ build-script \end_layout \begin_layout Standard + +\change_deleted -712698321 1501230298 \begin_inset VSpace defskip \end_inset +\change_unchanged + \end_layout \begin_layout Standard + +\change_deleted -712698321 1501230296 \begin_inset Newpage pagebreak \end_inset +\change_unchanged + \end_layout -\begin_layout Standard +\begin_layout LyX-Code \family sans #!/bin/sh \end_layout -\begin_layout Standard +\begin_layout LyX-Code \family sans # \end_layout -\begin_layout Standard +\begin_layout LyX-Code \family sans notangle -Rbuild-script $1 | env NOWEB_SOURCE=$1 NOWEB_OUTPUT_DIR=$2 sh \end_layout \begin_layout Standard + +\change_deleted -712698321 1501230299 \begin_inset VSpace defskip \end_inset +\change_unchanged + \end_layout \begin_layout Standard @@ -24778,6 +24869,13 @@ Flags \end_inset which is to be set to +\change_inserted -712698321 1501230552 + +\end_layout + +\begin_layout LyX-Code + +\change_deleted -712698321 1501230577 \begin_inset Newline newline \end_inset @@ -24786,8 +24884,12 @@ Flags \end_inset +\change_unchanged + \family typewriter parselog=$$s/scripts/listerrors +\change_deleted -712698321 1501230575 + \family default \begin_inset Quotes erd @@ -24797,6 +24899,12 @@ parselog=$$s/scripts/listerrors \begin_inset Newline newline \end_inset + +\change_inserted -712698321 1501230544 + +\end_layout + +\begin_layout Standard This will run any errors that are generated by the \begin_inset Quotes eld \end_inset @@ -25154,23 +25262,31 @@ Edit Sources \end_layout \begin_layout Standard + +\change_deleted -712698321 1501232274 \begin_inset VSpace defskip \end_inset +\change_inserted -712698321 1501232276 + \end_layout -\begin_layout Standard +\begin_layout LyX-Code -\family sans +\size footnotesize echo "LYXCMD:monitor:server-goto-file-row:@FILE@ @LINE@" >~/.lyxpipe.in \end_layout \begin_layout Standard + +\change_deleted -712698321 1501232278 \begin_inset VSpace defskip \end_inset +\change_unchanged + \end_layout \begin_layout Standard @@ -25190,7 +25306,9 @@ With this, whenever you are using ddd and find a point in the program that Note however that you must enable the \SpecialChar LyX server to get this feature working (it is disabled by default). - You can enable it in + +\change_deleted -712698321 1501232597 +You can enable it in \family sans Preferences \family default @@ -25223,12 +25341,29 @@ server pipe \end_layout \begin_layout Standard + +\change_inserted -712698321 1501232576 +Sec. +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "sec:Starting-the-Server" + +\end_inset + + explains how to do that +\change_deleted -712698321 1501232579 Read the \SpecialChar LyX server documentation in the \emph on Customization Manual \emph default - for further information. + for further information +\change_unchanged +. \end_layout \begin_layout Subsubsection