Change the default value for --max-iterations to 4

Author: minoki

CHANGELOG.md

@@ -1,11 +1,12 @@
-Version 0.7.0 (2024-XX-XX)
+Version 0.7.0 (2025-XX-XX)
 -----
 
 The main part of ClutTeX is now written in Standard ML, and compiled to Lua by LunarML.
 
 Changes:
 
 * Some behavior of ClutTeX can now be customized with a configuration file: `temporary-directory` and `color` keys are available.
+* The default value for `--max-iterations` is now 4 (previous: 3).
 
 Version 0.6 (2023-11-18)
 -----

README.md

@@ -58,7 +58,7 @@ Command-line Options
   Cannot be used with `--output-directory`.
 * `--max-iterations=N`
   Maximum number of running TeX to resolve cross-references.
-  \[default: 3\]
+  \[default: 4\]
 * `--[no-]change-directory`
   Change the current working directory to the output directory when running TeX.
 * `--watch[=ENGINE]`

doc/cluttex-ja.tex

@@ -89,7 +89,7 @@ \section{コマンドライン}
   \texttt{--output-directory}との併用はできない。
 \item[\texttt{--max-iterations=\metavar{N}}]
   相互参照の解決等のために最大何回処理を行うかを指定する。
-  デフォルト：3
+  デフォルト：4
 \item[\texttt{--watch[=\metavar{ENGINE}]}]
   入力ファイルを監視する。
   別途、\texttt{fswatch}プログラムまたは\texttt{inotifywait}プログラムが必要となる場合がある。

doc/cluttex.1

@@ -41,7 +41,7 @@ Clean intermediate files before running TeX.
 Cannot be used with --output-directory.
 .It Fl \-max-iterations Ns = Ns Ar N
 Maximum number of running TeX to resolve cross-references.
-[default: 3]
+[default: 4]
 .It Fl \-start-with-draft
 Start with draft mode.
 .It Fl \-change-directory , Fl \-no-change-directory

doc/cluttex.tex

@@ -66,7 +66,7 @@ \section{Command-line usage}
   Cannot be used in conjunction with \texttt{--output-directory}.
 \item[\texttt{--max-iterations=\metavar{N}}]
   Set maximum number of run, for resolving cross-references and etc.
-  Default: 3
+  Default: 4
 \item[\texttt{--watch[=\metavar{ENGINE}]}]
   Watch input files for change.
   May need an external program to be available.

src/main.sml

@@ -895,7 +895,7 @@ fun main () = let val (options, rest) = HandleOptions.parse (AppOptions.init, Co
                         , engine_executable = #engine_executable options
                         , output = output
                         , fresh = #fresh options
-                        , max_iterations = Option.getOpt (#max_iterations options, 3)
+                        , max_iterations = Option.getOpt (#max_iterations options, 4)
                         , start_with_draft = #start_with_draft options
                         , watch = #watch options
                         , change_directory = Option.getOpt (#change_directory options, false)