head	1.10;
access;
symbols
	pkgsrc-2026Q1:1.10.0.2
	pkgsrc-2026Q1-base:1.10
	pkgsrc-2025Q4:1.9.0.2
	pkgsrc-2025Q4-base:1.9
	pkgsrc-2025Q3:1.4.0.4
	pkgsrc-2025Q3-base:1.4
	pkgsrc-2025Q2:1.4.0.2
	pkgsrc-2025Q2-base:1.4
	pkgsrc-2025Q1:1.3.0.16
	pkgsrc-2025Q1-base:1.3
	pkgsrc-2024Q4:1.3.0.14
	pkgsrc-2024Q4-base:1.3
	pkgsrc-2024Q3:1.3.0.12
	pkgsrc-2024Q3-base:1.3
	pkgsrc-2024Q2:1.3.0.10
	pkgsrc-2024Q2-base:1.3
	pkgsrc-2024Q1:1.3.0.8
	pkgsrc-2024Q1-base:1.3
	pkgsrc-2023Q4:1.3.0.6
	pkgsrc-2023Q4-base:1.3
	pkgsrc-2023Q3:1.3.0.4
	pkgsrc-2023Q3-base:1.3
	pkgsrc-2023Q2:1.3.0.2
	pkgsrc-2023Q2-base:1.3;
locks; strict;
comment	@# @;


1.10
date	2026.03.09.17.32.36;	author wiz;	state Exp;
branches;
next	1.9;
commitid	qwFMhA2ODF8EckxG;

1.9
date	2025.11.19.15.54.26;	author gutteridge;	state Exp;
branches;
next	1.8;
commitid	8Zb9yDGUOwn0bbjG;

1.8
date	2025.11.19.14.36.03;	author gutteridge;	state Exp;
branches;
next	1.7;
commitid	wpMW94OMkCNjLajG;

1.7
date	2025.11.19.09.09.39;	author wiz;	state Exp;
branches;
next	1.6;
commitid	9raYuRRBTossX8jG;

1.6
date	2025.11.18.08.45.26;	author wiz;	state Exp;
branches;
next	1.5;
commitid	WdUmrDb4t2T8R0jG;

1.5
date	2025.11.18.08.43.40;	author wiz;	state Exp;
branches;
next	1.4;
commitid	3AOFYIVF8j0yQ0jG;

1.4
date	2025.06.06.23.10.26;	author wiz;	state Exp;
branches;
next	1.3;
commitid	v3N2ueyCpspEWSXF;

1.3
date	2023.05.26.20.38.47;	author schmonz;	state Exp;
branches;
next	1.2;
commitid	T31tVOILmNfsXvqE;

1.2
date	2020.03.24.17.46.28;	author nia;	state dead;
branches;
next	1.1;
commitid	RT1qx6CrNGc2eG1C;

1.1
date	2020.03.18.18.01.47;	author joerg;	state Exp;
branches;
next	;
commitid	uS4mydorQL2kvU0C;


desc
@@


1.10
log
@lowdown: update to 3.0.0.

Added initial support for outputting modern Unix manpages with
-tmdoc. This is intended as a replacement for the legacy -tman.
Supplement this with --roff-manpage, which accepts a markdown file
that looks like a Unix manpage and attempts to convert it into a
well-formed mdoc or man. Most of this is purely syntactic, but
several sections in Unix manpages (e.g., the NAME and SYNOPSIS)
have a rigorous syntax that this mode attempts to output.

Several minor (but breaking) changes to the API to take up fewer
bits in the oflags field of struct lowdown_opts: consolidate all
XXX_NOLINK, XXX_RELLINK, and XXX_SHORTLINK as LOWDOWN_NOLINK,
LOWDOWN_RELLINK, and LOWDOWN_SHORTLINK. This only applies to the
LOWDOWN_MAN, LOWDOWN_MS, and LOWDOWN_TERM output modes. The earlier
LOWDOWN_NROFF output mode is deprecated and is now an alias for
LOWDOWN_MS, which should be used moving forward.

Do the same with the various XXX_SKIP_HTML bits.

Deprecate the lowdown_nroff_xxx in favour of lowdown_roff_xxx. The
functions remain as deprecated and passing through to the new
equivalents.

Deprecate the macro variables LOWDOWN_NROFF_GROFF LOWDOWN_NROFF_NUMBERED
LOWDOWN_NROFF_MANPAGE LOWDOWN_NROFF_ENDNOTES in favour of their
ROFF names. The old macros are aliased for compatibility.

Library bumped from version 2 to 3 for those reasons.

Tweak the behaviour of -tterm and --term-no-links (or --term-no-rellinks)
with respect to embedded images and no text so that there's always
a clickable link and image component, if possible.

Add --roff-no-rellinks, similar to --term-no-rellinks. Respect
--roff-short-links in more cases as well.

Change the behaviour of -tms and -tman where --roff-no-links (or
the new --roff-no-rellinks) will have consistent behaviour even if
--roff-traditional is not specified.

Fix that, when using lowdown-diff for the terminal, resetting the
colour after an insertion or delete would trigger the black colour,
which obviously doesn't work with a black background. Instead, use
the default colour.

When generating header identifiers in -thtml, incorporate codespan
text as well. This is the same as pandoc's default behaviour as
well.
@
text
@$NetBSD: patch-Makefile,v 1.9 2025/11/19 15:54:26 gutteridge Exp $

Libtoolize for portable shared libraries.

--- Makefile.orig	2026-03-07 20:47:42.000000000 +0000
+++ Makefile
@@@@ -1,5 +1,6 @@@@
 .PHONY: regress regen_regress valgrind
 .SUFFIXES: .xml .md .html .pdf .1 .1.html .3 .3.html .5 .5.html .thumb.jpg .png .in.pc .pc .old.md
+.SUFFIXES: .lo
 
 include Makefile.configure
 WWWDIR		 = /var/www/vhosts/kristaps.bsd.lv/htdocs/lowdown
@@@@ -200,7 +201,12 @@@@ REGRESS_ENV	 = LC_ALL=C.UTF-8
 
 REGRESS_ENV	 = LC_ALL=C.UTF-8
 
-all: bins lowdown.pc $(LIB_SO)
+LIBTOOL                 = libtool --tag=CC
+LT_OBJS                 = $(OBJS:C/\.o$/.lo/g)
+LT_COMPAT_OBJS  = $(COMPAT_OBJS:C/\.o$/.lo/g)
+
+all: bins lowdown.pc liblowdown.la
+
 bins: lowdown lowdown-diff
 
 www: all $(HTMLS) $(PDFS) $(THUMBS) $(TEXTS) lowdown.tar.gz lowdown.tar.gz.sha512
@@@@ -213,15 +219,20 @@@@ installwww: www
 	$(INSTALL) -m 0444 lowdown.tar.gz $(WWWDIR)/snapshots
 	$(INSTALL) -m 0444 lowdown.tar.gz.sha512 $(WWWDIR)/snapshots
 
-lowdown: $(LIB_LOWDOWN) $(MAIN_OBJS) main.o
-	$(CC) -o $@@ main.o $(MAIN_OBJS) $(LIB_LOWDOWN) $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
+lowdown: liblowdown.la $(LT_COMPAT_OBJS) main.o
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.o $(LT_COMPAT_OBJS) liblowdown.la $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
 
+# For regress, we build this (just like lowdown) so that its libtool wrapper works.
+# At install, we'll still just make a hard link to lowdown like upstream.
 lowdown-diff: lowdown
-	ln -f lowdown lowdown-diff
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.o $(LT_COMPAT_OBJS) liblowdown.la $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
 
 $(LIB_ST): $(OBJS) $(COMPAT_OBJS)
 	$(AR) rs $@@ $(OBJS) $(COMPAT_OBJS)
 
+liblowdown.la: $(LT_OBJS) $(LT_COMPAT_OBJS)
+	$(LIBTOOL) --mode=link $(CC) -o $@@ $(LT_OBJS) $(LT_COMPAT_OBJS) $(LDFLAGS) $(LDADD_MD5) -lm $(LDLIBS) -version-number $(LIBVER) -rpath $(LIBDIR)
+
 $(LIB_SO): $(OBJS) $(COMPAT_OBJS)
 	$(CC) $(LINKER_SOFLAG) -o $(LIB_SOVER) $(OBJS) $(COMPAT_OBJS) \
 		$(LDFLAGS) $(LDADD_MD5) -lm \
@@@@ -251,8 +262,8 @@@@ install: bins
 	$(INSTALL_DATA) share/man/* $(DESTDIR)$(SHAREDIR)/lowdown/man
 	$(INSTALL_DATA) share/ms/* $(DESTDIR)$(SHAREDIR)/lowdown/ms
 	$(INSTALL_DATA) share/odt/* $(DESTDIR)$(SHAREDIR)/lowdown/odt
-	$(INSTALL_PROGRAM) lowdown $(DESTDIR)$(BINDIR)
-	$(INSTALL_PROGRAM) lowdown-diff $(DESTDIR)$(BINDIR)
+	$(LIBTOOL) --mode=install $(INSTALL_PROGRAM) lowdown $(DESTDIR)$(BINDIR)
+	ln $(DESTDIR)$(BINDIR)/lowdown $(DESTDIR)$(BINDIR)/lowdown-diff
 	for f in $(MAN1S) $(MAN5S) ; do \
 		name=`basename $$f .html` ; \
 		section=$${name##*.} ; \
@@@@ -283,6 +294,9 @@@@ uninstall_shared: uninstall_lib_common
 uninstall_shared: uninstall_lib_common
 	rm -f $(LIBDIR)/$(LIB_SOVER) $(LIBDIR)/$(LIB_SO)
 
+install_pkgsrc: liblowdown.la install_lib_common
+	$(LIBTOOL) --mode=install $(BSD_INSTALL_LIB) liblowdown.la $(DESTDIR)$(LIBDIR)
+
 install_shared: $(LIB_SO) install_lib_common
 	$(INSTALL_LIB) $(LIB_SOVER) $(DESTDIR)$(LIBDIR)
 	( cd $(DESTDIR)$(LIBDIR) && ln -sf $(LIB_SOVER) $(LIB_SO) )
@@@@ -370,6 +384,9 @@@@ $(HTMLS): versions.xml lowdown
 .xml.html:
 	sblg -t template.xml -s date -o $@@ -C $< $< versions.xml
 
+.c.lo:
+	$(LIBTOOL) --mode=compile $(CC) $(CFLAGS) -c -o $@@ $<
+
 .md.xml: lowdown
 	( echo "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>" ; \
 	  echo "<article data-sblg-article=\"1\">" ; \
@@@@ -424,15 +441,15 @@@@ lowdown.tar.gz:
 	( cd .dist/ && tar zcf ../$@@ lowdown-$(VERSION) )
 	rm -rf .dist/
 
-$(OBJS) $(COMPAT_OBJS) main.o: config.h
+$(LT_OBJS) $(COMPAT_OBJS) main.o: config.h
 
-$(OBJS): extern.h lowdown.h
+$(LT_OBJS): extern.h lowdown.h
 
-term.o: term.h
+term.lo: term.h
 
-roff.o roff_manpage.o: roff.h
+roff.lo roff_manpage.lo: roff.h
 
-main.o: lowdown.h
+main.lo: lowdown.h
 
 clean:
 	rm -f $(OBJS) $(COMPAT_OBJS) main.o
@


1.9
log
@lowdown: fix compat function linking differently

As of 2.0.4, upstream actually added context to handle this linking
while keeping other symbol visibility hidden as they want. However, it
wasn't factored in to the "libtoolization" changes that were made for
pkgsrc purposes. (PR pkg/59614, PR pkg/59619.)
@
text
@d1 1
a1 1
$NetBSD: patch-Makefile,v 1.8 2025/11/19 14:36:03 gutteridge Exp $
d5 1
a5 1
--- Makefile.orig	2025-11-17 03:25:46.000000000 +0000
d14 1
a14 1
@@@@ -189,7 +190,12 @@@@ REGRESS_ARGS	+= "--parse-no-deflists"
d16 1
a16 1
 REGRESS_ENV	 = LC_ALL=en_US.UTF-8
d27 2
a28 2
 www: all $(HTMLS) $(PDFS) $(THUMBS) lowdown.tar.gz lowdown.tar.gz.sha512
@@@@ -202,15 +208,20 @@@@ installwww: www
d52 1
a52 1
@@@@ -240,8 +251,8 @@@@ install: bins
d63 1
a63 1
@@@@ -272,6 +283,9 @@@@ install_lib_common: lowdown.pc
d73 3
a75 3
@@@@ -344,6 +358,9 @@@@ diff.diff.pdf: diff.md diff.old.md lowdo
 
 $(HTMLS): versions.xml lowdown
d83 1
a83 1
@@@@ -396,13 +413,13 @@@@ lowdown.tar.gz:
d88 1
a88 1
+$(LT_OBJS) $(LT_COMPAT_OBJS) main.lo: config.h
d96 3
@


1.8
log
@lowdown: fix builds on platforms that require compat functions

Addresses PR pkg/59614 from Piper McCorkle (Linux) and PR pkg/59619
from db7@@mini.fritz.box (macOS).
@
text
@d1 1
a1 1
$NetBSD: patch-Makefile,v 1.7 2025/11/19 09:09:39 wiz Exp $
a4 3
Don't "avoid exporting internal functions", as this causes any necessary
compat functions to fail to link when generating the program itself. 

d14 1
a14 10
@@@@ -169,8 +170,6 @@@@ LIB_SOVER	 = liblowdown.$(LINKER_SOSUFFI
 
 # Because the objects will be compiled into a shared library:
 CFLAGS		+= -fPIC
-# To avoid exporting internal functions (lowdown.h has default visibility).
-CFLAGS		+= -fvisibility=hidden
 
 # Only for MarkdownTestv1.0.3 in regress/original.
 
@@@@ -189,7 +188,12 @@@@ REGRESS_ARGS	+= "--parse-no-deflists"
d28 1
a28 1
@@@@ -202,15 +206,20 @@@@ installwww: www
d34 2
a35 2
+lowdown: liblowdown.la $(MAIN_OBJS) main.o
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.o $(MAIN_OBJS) liblowdown.la $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
d41 1
a41 1
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.o $(MAIN_OBJS) liblowdown.la $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
d52 1
a52 1
@@@@ -240,8 +249,8 @@@@ install: bins
d63 1
a63 1
@@@@ -272,6 +281,9 @@@@ install_lib_common: lowdown.pc
d73 1
a73 1
@@@@ -344,6 +356,9 @@@@ diff.diff.pdf: diff.md diff.old.md lowdo
d83 1
a83 1
@@@@ -396,13 +411,13 @@@@ lowdown.tar.gz:
@


1.7
log
@lowdown: fix libtoolization
@
text
@d1 1
a1 1
$NetBSD: patch-Makefile,v 1.4 2025/06/06 23:10:26 wiz Exp $
d5 3
d17 10
a26 1
@@@@ -189,7 +190,12 @@@@ REGRESS_ARGS	+= "--parse-no-deflists"
d40 1
a40 1
@@@@ -202,15 +208,20 @@@@ installwww: www
d64 1
a64 1
@@@@ -240,8 +251,8 @@@@ install: bins
d75 1
a75 1
@@@@ -272,6 +283,9 @@@@ install_lib_common: lowdown.pc
d85 1
a85 1
@@@@ -344,6 +358,9 @@@@ diff.diff.pdf: diff.md diff.old.md lowdo
d95 1
a95 1
@@@@ -396,13 +413,13 @@@@ lowdown.tar.gz:
@


1.6
log
@lowdown: update to 2.0.4.

Hot-fix 2.0.3 with correct Mac OS X conventions in shared library versioning.
@
text
@d28 2
a29 1
@@@@ -203,14 +209,19 @@@@ installwww: www
d32 1
a32 1
 lowdown: $(LIB_LOWDOWN) $(MAIN_OBJS) main.o
d34 2
a35 1
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.o $(MAIN_OBJS) $(LIB_LOWDOWN) $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
d41 1
a41 1
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.o $(MAIN_OBJS) $(LIB_LOWDOWN) $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
@


1.5
log
@lowdown: update to 2.0.3.

Automatically create the correct shared library type ("dylib") on
Mac OS X. Fix how image links within links have their link content
displayed using OSC8 encoding in terminal mode Fix how -tlatex,
-tms, and -tman escape URLs or otherwise do percent and space
encoding.
@
text
@d5 1
a5 1
--- Makefile.orig	2025-11-15 22:39:36.000000000 +0000
d14 1
a14 1
@@@@ -177,7 +178,11 @@@@ REGRESS_ARGS	+= "--parse-no-deflists"
d18 1
a18 1
-all: bins lowdown.pc liblowdown.$(LINKER_SOSUFFIX)
d24 1
d28 1
a28 1
@@@@ -191,14 +196,19 @@@@ installwww: www
d41 1
a41 1
 liblowdown.a: $(OBJS) $(COMPAT_OBJS)
d47 4
a50 4
 liblowdown.$(LINKER_SOSUFFIX): $(OBJS) $(COMPAT_OBJS)
 	$(CC) $(LINKER_SOFLAG) -o $@@.$(LIBVER) $(OBJS) $(COMPAT_OBJS) $(LDFLAGS) $(LDADD_MD5) -lm \
 		-Wl,${LINKER_SONAME},$@@.$(LIBVER) $(LDLIBS)
@@@@ -227,8 +237,8 @@@@ install: bins
d61 1
a61 1
@@@@ -259,6 +269,9 @@@@ install_lib_common: lowdown.pc
d63 1
a63 1
 	rm -f $(LIBDIR)/liblowdown.$(LINKER_SOSUFFIX).$(LIBVER) $(LIBDIR)/liblowdown.$(LINKER_SOSUFFIX)
d68 4
a71 4
 install_shared: liblowdown.$(LINKER_SOSUFFIX) install_lib_common
 	$(INSTALL_LIB) liblowdown.$(LINKER_SOSUFFIX).$(LIBVER) $(DESTDIR)$(LIBDIR)
 	( cd $(DESTDIR)$(LIBDIR) && ln -sf liblowdown.$(LINKER_SOSUFFIX).$(LIBVER) liblowdown.$(LINKER_SOSUFFIX) )
@@@@ -331,6 +344,9 @@@@ diff.diff.pdf: diff.md diff.old.md lowdo
d81 1
a81 1
@@@@ -383,13 +399,13 @@@@ lowdown.tar.gz:
@


1.4
log
@lowdown: update to 2.0.2.

Version 2.0.2, 2025-02-16

Fix table separators in -tterm. Fix running make regress without
a UTF-8 locale set, which would cause different output for the
-tterm tests.

Version 2.0.0, 2025-01-25

Formalise using semantic versioning ("semver"). The prior version
(1.4.0) introduced API changes that were incompatible: future
versions will follow semver to prevent confusion.

Adds some missing template files to the share directory.

Fix how links in -tterm have their ANSI escapes closed out.

Lastly, to address downstream breakage when using nested Mac OS X
sandboxes, a special argument SANDBOX_INIT_ERROR_IGNORE value may
be passed during the make build sequence. If set to always, errors
from the underlying Mac OS X sandbox are always ignored. If set to
any other value, the user must set the environment variable
SANDBOX_INIT_ERROR_IGNORE to ignore these errors. This is only
relevant to Mac OS X builds with the sandbox feature enabled during
configuration.

Version 1.4.0, 2024-12-25

Deprecate the --nroff argument prefix in favour of --roff, so for
example --nroff-traditional becomes --roff-traditional. The old
prefix is retained and will not be removed. Deprecated old forms
(e.g., --nroff-no-groff) did not get a replacement.

Deprecate --term-nolinks and --term-shortlinks in favour of
--term-no-links and --term-short-links, respectively. The old forms
are retained and will not be removed.

Add --term-hpadding and clarify the roles of --term-cols,
--term-hmargin, and --term-width. Also document auto argument to
-term-hmargin. The default output looks the same as it did before,
but --term-hpadding=0 can now omit any leading characters.

Add --term-no-rellinks to omit only relative links. This is useful
because terminal output doesn't have a concept of a "relative"
link.

Add passing literal strings as initial values to --template.

Document --term-hmargin=auto, previously undocumented as centre.

Use UTF-8 sequences for -tterm lines: horizontal lines, tables,
block vertical lines, etc. Simplify the image link output to look
a little more like pandoc.

API change (hence the minor version bump): lowdown_tree_rndr(3)
now also accepts a pointer to the options. This is to enable
debugging of the parse tree of --template. Now, passing -s --template
to -ttree will produce the template's parse tree alongside the
parsed content of the input.

API change (hence the minor version bump): moving terminal-specific
members of lowdown_opts into lowdown_opts_term.

Version 1.3.2, 2024-12-10

Add --template functionality to -tman, -tms, and -tgemini.

Add not() to the --template functions and document escapelatex().
Recognise a special modifier -- at the end of control statements
(e.g., $endfor--$, which consumes up and and including the end-of-line.
This is necessary for integrating templates with roff-based languages
that are line sensitive.

Add escapegemini and escaperoff modifier families.

Clarify that any empty statement, even with only white-space,
evaluates to the $ literal. This simplifies the parser and reduces
corner cases. (Earlier, an empty statement with white-space was
ignored, but an empty statement without white-space was a literal
$)

Version 1.3.1, 2024-12-05

Add --template functionality to -tlatex.

Add and() and or() as initial values to template expressions. These
allow for ifdef to test for multiple values at once.

Version 1.3.0, 2024-11-30

Specify that characters not complying with the metadata key
specification are replaced with underscores (which are allowed by
the metadata key character restrictions) instead of as curently
with question marks (which are not valid metadata key characters).

Add new --template functionality, initially for -thtml. This is
still experimental, so transformations and syntax might change. It
allows for templating the output HTML file.

Version 1.2.0, 2024-10-24

Output OSC8 hyperlinks in -tterm mode. See OSC8 Adoption for the
gist. This won't affect terminals not supporting links (such as
with OpenBSD's default xterm). As of this change, all links (including
image links) and link titles will be clickable in supporting
terminals unless --term-no-ansi is given.

Conditionally output UR/UE or MT/ME macros for -tman links. This
makes links be "live" in some -tman utilities.

Add metadata html header, latex header, ms header, and man header
for adding media-specific invocations in the document headers.

Have footnotes in -tms be linked: clicking on a footnote number
will jump to that footnote in the document.

Introduce --nroff-endnotes, which adds a new flag to the public
API (hence the minor number addition). This delays printing of -tms
footnotes until the end of the document, making them endnotes.

Deprecate the --nroff-no-groff flag in favour of --nroff-traditional,
as the changes it effects equally favour mandoc and Heirloom troff.
Does not change the code interface, which uses the same macro name
as before.

Have metadata not be processed by the "smart" typography at all.
This is because some values are links and others are mainlined
directly into output and should not be touched.

Be specific about the behaviour of nested links. This is inconsistent
across the various Markdown implementations (and CommonMark).
Document and stick to a standard.

Version 1.1.2, 2024-09-29

Add documentation for --html-titleblock and slightly change semantics
where it will print regardless if in -s mode.

Add regression code coverage to main website, include make rules
for generating coverage. Many more regression tests to exercise
coverage.

Version 1.1.1, 2024-09-24

Fix UTF8 handling on Mac OS X. Prior to this, some UTF8 characters
(such as smart punctuation) were being garbled on -Tgemini and
-Tterm output. These now render properly thanks to an excellent
pull request contribution (#140).

Hack around more buggy Mac OS X software, specifically their version
of makewhatis(8). While man(7) specifically allows for header macros
(SH) to have their contents on the subsequent line, this breaks
buggy software that erroneously expects headers to have their
content on the same line. This version, thanks to another excellent
pull request (#138), adds a hack for that specific condition.

Version 1.1.0, 2023-11-07

Accept GitHub and MDN-style admonitions. Admonitions are block-quotes
that begin with a bold phrase (e.g., note). The output rendering
is only for -thtml.

Accept GitHub-style superscripts and make them the default.
Previously, lowdown accepted only the traditional Markdown
superscripts; however, pandoc and other tools use GFM syntax by
default, so use this instead and make classical parsing into an
option --parse-super-short.

Add subscript support in the same way as superscript support.
Subscripts overlap with strike-throughs, which are enabled by
default. However, strike-throughs only appear for double-tildes.

Normalise the shared library to version 1, tied to the major number
of the package, and increment the minor number of the package
following the above API changes.

In -tterm mode, don't print metadata unless -s is specified, in
which case print the title, author, and date just like in the other
modes. Provide a --term-all-meta option to print all metadata like
before.

Make some small fixes to -tgemini regarding block quotes and block
code.

Lastly, significantly update lowdown(3) to document the AST generated
by the parser.
@
text
@d1 1
a1 1
$NetBSD: patch-Makefile,v 1.3 2023/05/26 20:38:47 schmonz Exp $
d5 1
a5 1
--- Makefile.orig	2025-02-16 20:49:33.000000000 +0000
d14 1
a14 1
@@@@ -157,7 +158,11 @@@@ REGRESS_ARGS	+= "--parse-no-deflists"
d18 4
a21 4
-all: bins lowdown.pc liblowdown.so
+LIBTOOL		 = libtool --tag=CC
+LT_OBJS		 = $(OBJS:C/\.o$/.lo/g)
+LT_COMPAT_OBJS	 = $(COMPAT_OBJS:C/\.o$/.lo/g)
d27 1
a27 2
@@@@ -170,15 +175,21 @@@@ installwww: www
 	$(INSTALL) -m 0444 lowdown.tar.gz $(WWWDIR)/snapshots
d30 4
a33 5
-lowdown: liblowdown.a main.o
-	$(CC) -o $@@ main.o liblowdown.a $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
+lowdown: liblowdown.la main.lo
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.lo -llowdown $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
+
d36 1
a36 4
+lowdown-diff: liblowdown.la main.lo
+	$(LIBTOOL) --mode=link $(CC) -o $@@ main.lo -llowdown $(LDFLAGS) $(LDADD_MD5) -lm $(LDADD)
 
-lowdown-diff: lowdown
d38 1
d46 4
a49 4
 liblowdown.so: $(OBJS) $(COMPAT_OBJS)
 	$(CC) -shared -o $@@.$(LIBVER) $(OBJS) $(COMPAT_OBJS) $(LDFLAGS) $(LDADD_MD5) -lm -Wl,${LINKER_SONAME},$@@.$(LIBVER) $(LDLIBS)
 	ln -sf $@@.$(LIBVER) $@@
@@@@ -206,8 +217,8 @@@@ install: bins
d60 1
a60 1
@@@@ -238,6 +249,9 @@@@ install_lib_common: lowdown.pc
d62 1
a62 1
 	rm -f $(LIBDIR)/liblowdown.so.$(LIBVER) $(LIBDIR)/liblowdown.so
d67 4
a70 4
 install_shared: liblowdown.so install_lib_common
 	$(INSTALL_LIB) liblowdown.so.$(LIBVER) $(DESTDIR)$(LIBDIR)
 	( cd $(DESTDIR)$(LIBDIR) && ln -sf liblowdown.so.$(LIBVER) liblowdown.so )
@@@@ -310,6 +324,9 @@@@ diff.diff.pdf: diff.md diff.old.md lowdo
d80 1
a80 1
@@@@ -362,13 +379,13 @@@@ lowdown.tar.gz:
@


1.3
log
@Update to 1.0.2. From the changelog:

1.0.2:

Accept DOS CRLF newlines in all situations. Prior to this, CRLF newlines
would cause problems in some contexts.

Add support for pandoc title blocks as a metadata block syntax choice.
Pandoc and MMD syntaxes are mutually exclusive, so only one may be used
in any given document. The syntax is documented in lowdown(5).

While there, support starting and ending an MMD metadata block with
"---" on its own line, as in the MMD specification.

Add the --html-titleblock option. If specified, output a Pandoc-style
title header.

Pandoc has a poorly-executed feature where -stman outputs have the title
metadata line additionally parsed into a manpage title, section, and
optional source and volume. This allows titles like `TITLE(1) Source |
Volume` to be split into their respective manpage parts -- but only when
in -stman mode, so an HTML document generated from the same page will
not inherit the additional parsing. In lowdown(5), introduce this
parsing for all outputs if --parse-mantitle is specified, which is now
the default.

Behaviour change: do not use "Untitled article" as the default title for
media supporting (or requiring) titles when in standalone -s mode.
Instead, just the empty string if a title is required. This is a more
logical choice: not only is "Untitled article" language-specific, it
also assumes the output is an article. For the previous behaviour,
`--mtitle="Untitled article"` may always be used.

Fix support for GFM tables. Specifically, don't arbitrarily require a
certain three or more dashes/colons per cell in the layout row. Also
allow for escaped vertical bars in the header row.

1.0.1:

Numerous build and configuration improvements (via oconfigure) for
building into WASI targets and on Mac OS X.

Add -L for listing all metadata keys.

Some fixes to smart typography around hard linebreaks. These aren't
likely to affect normal documents.

Recognise void HTML elements as block elements.

Switch between types (e.g., unordered to ordered) instead of continuing
with the current list type. Fix parsing of block versus non-block lists
when switching between list types. Fix parsing of block versus non-block
lists when sublists contain block elements, but top-level lists don't.
The Markdown spec isn't clear on how to accept these instances, so use
pandoc as a guiding tool.

For -tman output, normalise list marker widths (unordered or ordered)
to three spaces by default, increasing for ordered lists depending on
the number of entries. For -tms, it's five. Make other small cleanups
to -tms, making sure that paragraph indentation looks the same as
with -tlatex.

Fix that escaped text (e.g., `\-\-foo`) is not changed by the smart
typography formatter.

Use `TP` in -tman for definition lists. To align with existing
lists, use a subsequent paragraph offset of three. Similarly, use
`XP` for -tms.

pkgsrc changes:

- Libtoolize for portable shared libraries.
@
text
@d1 1
a1 1
$NetBSD$
d5 1
a5 1
--- Makefile.orig	2023-05-20 19:09:00.000000000 +0000
d8 2
a9 2
 .PHONY: regress regen_regress
 .SUFFIXES: .xml .md .html .pdf .1 .1.html .3 .3.html .5 .5.html .thumb.jpg .png .in.pc .pc .valgrind .old.md .diff-valgrind
d13 2
d16 1
a16 3
@@@@ -125,7 +126,11 @@@@ REGRESS_ARGS	+= "--parse-no-deflists"
 
 VALGRIND_ARGS	 = -q --leak-check=full --leak-resolution=high --show-reachable=yes
d26 2
a27 2
 valgrind: $(VALGRINDS) $(VALGRINDDIFFS)
@@@@ -173,11 +178,13 @@@@ installwww: www
d35 1
a35 3
 
-lowdown-diff: lowdown
-	ln -f lowdown lowdown-diff
d41 3
a45 3
@@@@ -186,14 +193,17 @@@@ liblowdown.so: $(OBJS) $(COMPAT_OBJS)
 	$(CC) -shared -o $@@.$(LIBVER) $(OBJS) $(COMPAT_OBJS) $(LDFLAGS) $(LDADD_MD5) -lm -Wl,${LINKER_SONAME},$@@.$(LIBVER) $(LDLIBS)
 	ln -sf $@@.$(LIBVER) $@@
d50 7
a56 6
 install: bins
 	mkdir -p $(DESTDIR)$(BINDIR)
 	mkdir -p $(DESTDIR)$(MANDIR)/man1
 	mkdir -p $(DESTDIR)$(MANDIR)/man5
 	mkdir -p $(DESTDIR)$(SHAREDIR)/lowdown/odt
 	$(INSTALL_DATA) share/odt/styles.xml $(DESTDIR)$(SHAREDIR)/lowdown/odt
d64 3
a66 3
@@@@ -212,6 +222,9 @@@@ install_lib_common: lowdown.pc
 		$(INSTALL_MAN) man/$$name $(DESTDIR)$(MANDIR)/man$$section ; \
 	done
d74 1
a74 1
@@@@ -279,6 +292,9 @@@@ diff.diff.pdf: diff.md diff.old.md lowdo
d84 1
a84 1
@@@@ -313,13 +329,13 @@@@ lowdown.tar.gz:
@


1.2
log
@lowdown: Update to 0.6.2

"Lots of small portability tweaks to the build system. This involves the newest oconfigure."
@
text
@d1 1
a1 1
$NetBSD: patch-Makefile,v 1.1 2020/03/18 18:01:47 joerg Exp $
d3 3
a5 1
--- Makefile.orig	2020-03-18 17:19:14.307880180 +0000
d7 96
a102 9
@@@@ -101,7 +101,7 @@@@ install: all
 distcheck: lowdown.tar.gz.sha512
 	mandoc -Tlint -Wwarning man/*.[135]
 	newest=`grep "<h1>" versions.xml | tail -n1 | sed 's![ 	]*!!g'` ; \
-	       [ "$$newest" == "<h1>$(VERSION)</h1>" ] || \
+	       [ "$$newest" = "<h1>$(VERSION)</h1>" ] || \
 		{ echo "Version $(VERSION) not newest in versions.xml" 1>&2 ; exit 1 ; }
 	rm -rf .distcheck
 	sha512 -C lowdown.tar.gz.sha512 lowdown.tar.gz
@


1.1
log
@Fix shell portability
@
text
@d1 1
a1 1
$NetBSD$
@