If we have to reparse the text line because we spring an input line trap,

[mandoc.git] / mchars_alloc.3

diff --git a/mchars_alloc.3 b/mchars_alloc.3
index 8c3f853492f24ac8a7572c6d217da5ab8132f2c7..eba81b5224ec8812de89ce16b876f1247e944311 100644 (file)
--- a/mchars_alloc.3
+++ b/mchars_alloc.3
@@ -1,4 +1,4 @@
-.\"    $Id: mchars_alloc.3,v 1.1 2014/08/05 05:48:56 schwarze Exp $
+.\"    $Id: mchars_alloc.3,v 1.2 2014/10/26 18:07:28 schwarze Exp $

 .\"
 .\" Copyright (c) 2014 Ingo Schwarze <schwarze@openbsd.org>
 .\"
 .\"
 .\" Copyright (c) 2014 Ingo Schwarze <schwarze@openbsd.org>
 .\"


@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"

-.Dd $Mdocdate: August 5 2014 $
+.Dd $Mdocdate: October 26 2014 $

 .Dt MCHARS_ALLOC 3
 .Os
 .Sh NAME
 .Dt MCHARS_ALLOC 3
 .Os
 .Sh NAME


@@ -59,6 +59,8 @@
 .Fa "size_t sz"
 .Fa "size_t *rsz"
 .Fc
 .Fa "size_t sz"
 .Fa "size_t *rsz"
 .Fc

+.Ft "const char *"
+.Fn mchars_uc2str "int codepoint"

 .Sh DESCRIPTION
 These functions translate Unicode character numbers and
 .Xr roff 7
 .Sh DESCRIPTION
 These functions translate Unicode character numbers and
 .Xr roff 7


@@ -199,6 +201,14 @@ output module use this function to render
 and
 .Ic \eC\(aq Ns Ar name Ns Ic \(aq
 escape sequences.
 and
 .Ic \eC\(aq Ns Ar name Ns Ic \(aq
 escape sequences.

+.Pp
+The function
+.Fn mchars_uc2str
+performs a reverse lookup of the Unicode
+.Fa codepoint
+and returns an ASCII string representation, or the string
+.Qq <?>
+if none is available.

 .Sh FILES
 These funtions are implemented in the file
 .Pa chars.c .
 .Sh FILES
 These funtions are implemented in the file
 .Pa chars.c .


@@ -218,6 +228,7 @@ following mandoc versions:
 .It Fn mchars_num2uc Ta 1.11.3 Ta \(em Ta \(em
 .It Fn mchars_spec2cp Ta 1.11.2 Ta Fn chars_spec2cp Ta 1.10.5
 .It Fn mchars_spec2str Ta 1.11.2 Ta Fn a2ascii Ta 1.5.3
 .It Fn mchars_num2uc Ta 1.11.3 Ta \(em Ta \(em
 .It Fn mchars_spec2cp Ta 1.11.2 Ta Fn chars_spec2cp Ta 1.10.5
 .It Fn mchars_spec2str Ta 1.11.2 Ta Fn a2ascii Ta 1.5.3

+.It Fn mchars_uc2str Ta 1.13.2 Ta \(em Ta \(em

 .El
 .Sh AUTHORS
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
 .El
 .Sh AUTHORS
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv