centeredline (27apr19)

git-svn-id: svn://tug.org/texlive/trunk@50931 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 74 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/centeredline/README.md b/Master/texmf-dist/doc/latex/centeredline/README.md
new file mode 100644
index 00000000000..90bcac86764
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/centeredline/README.md
@@ -0,0 +1,74 @@
+<!-- -->
+
+    Author:  Jean-Francois Burnol
+    Package: centeredline
+    Version: 1.0 (2019/04/27)
+    License: LPPL 1.3c
+    Copyright (C) 2019 Jean-Francois Burnol
+    <jfbu at free dot fr>
+
+# DESCRIPTION #
+
+After `\usepackage{centeredline}` you can use
+
+    \centeredline{....}
+
+to get contents centered, in a better way than with `\centerline`:
+
+1. `\verb` or other catcode changes are allowed,
+2. the centering (with respect to the surrounding text paragraph) will
+   be as expected if this all happens inside an item from a LaTeX list
+   environment,
+3. and material whose natural width exceeds the linewidth will get
+   properly centered too.
+
+The contents are executed in horizontal mode inside a group inside a
+`\hbox`.
+
+The macro itself maybe encountered in paragraph or in vertical mode. For
+example in vertical mode
+
+    \centeredline{\rule{\dimexpr-1cm+\paperwidth}{1pt}}
+    \centeredline{\rule{\dimexpr-1cm+\paperwidth}{1pt}}
+    \centeredline{\rule{\dimexpr-1cm+\paperwidth}{1pt}}
+
+will create horizontally centered on the page horizontal rules
+vertically separated by the baseline skip and ignoring the parskip.
+
+
+# HISTORY #
+
+I have used this macro since 2013 and it has served me well.
+
+I am making it public as is, without any re-thinking about whether it may
+have some limitations which I somehow did not encounter in my personal usage.
+Suggestions for improvements are welcome, and will be recorded although I do
+not expect to update the package anytime soon.
+
+
+# CHANGE LOG #
+
+- v1.0 (2019/04/27): First release.
+
+
+# LICENSE #
+
+This Work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License 1.3c.
+This version of this license is in
+
+> <http://www.latex-project.org/lppl/lppl-1-3c.txt>
+
+and the latest version of this license is in
+
+> <http://www.latex-project.org/lppl.txt>
+
+and version 1.3 or later is part of all distributions of
+LaTeX version 2005/12/01 or later.
+
+The Author of this Work is:
+
+> Jean-Francois Burnol `<jfbu at free dot fr>`
+
+This Work consists of the file `centeredline.sty` and
+accompanying `README.md`.