summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/latexindent/subsec-text-wrap-summary.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-08-01 20:35:09 +0000
committerKarl Berry <karl@freefriends.org>2021-08-01 20:35:09 +0000
commit07a6550aa7f741c870ad36d20f966bc13b0772c1 (patch)
treebd6cc9efc5df807a68e2b242058af6c586a78781 /Master/texmf-dist/doc/support/latexindent/subsec-text-wrap-summary.tex
parent124368ae4f0ebc3a7736c703764ab1555997e214 (diff)
latexindent (1aug21)
git-svn-id: svn://tug.org/texlive/trunk@60132 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/latexindent/subsec-text-wrap-summary.tex')
-rw-r--r--Master/texmf-dist/doc/support/latexindent/subsec-text-wrap-summary.tex26
1 files changed, 26 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/latexindent/subsec-text-wrap-summary.tex b/Master/texmf-dist/doc/support/latexindent/subsec-text-wrap-summary.tex
new file mode 100644
index 00000000000..89379eabbc2
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latexindent/subsec-text-wrap-summary.tex
@@ -0,0 +1,26 @@
+% arara: pdflatex: {shell: yes, files: [latexindent]}
+\subsection{Summary of text wrapping}
+ I consider%
+ \announce*{2021-07-31}{text wrap quick start}
+ the most useful starting point for text wrapping to be given in
+ \cref{subsec:textwrapping-quick-start} and \cref{subsubsec:text-wrap-remove-para-bfccb}.
+
+ Starting from \cref{lst:textwrap-qs-yaml}, it is likely that you will have to experiment
+ with making adjustments (such as that given in \cref{lst:textwrap14-yaml}) depending on
+ your preference.
+
+ It is important to note the following:
+ \index{verbatim!within summary of text wrapping}
+ \begin{itemize}
+ \item verbatim code blocks of all types will \emph{not} be affected by the text wrapping
+ routine. See the demonstration in \vref{lst:textwrap2-mod1}, together with environments:
+ \vref{lst:verbatimEnvironments}, commands: \vref{lst:verbatimCommands},
+ \texttt{noIndentBlock}: \cref{lst:noIndentBlock}, \texttt{specialBeginEnd}:
+ \vref{lst:special3-mod1};
+ \item comments will \emph{not} be affected by the text wrapping routine (see
+ \vref{lst:textwrap3-mod1});
+ \item it is possible to wrap text on a per-code-block and a per-name basis;
+ \announce{2018-08-13}*{updates to textWrapOptions}
+ \item indentation is performed \emph{after} the text wrapping routine; as such, indented code
+ will likely exceed any maximum value set in the \texttt{columns} field.
+ \end{itemize}