GitLab

Subsections are useful in case on name conflicts within a section.
Typically man pages in distributions are using the 'p' subsection.
They are also needed for the man pages of wrapper commands for example.

The absence of value between the section parentheses resulted in the
section being 0 (header files), which is unlikely to be the one wanted

This test depends on a nonportable option for date(1). I am not sure
that there is a good portable way to do this, so I just directly
included the seconds since epoch that it would have computed. We're
testing scdoc, not testing the local system's date command.

These tests fail depending on timezone and current time if the date
differs from the UTC date. This was remedied by using `date -u`, which
is POSIX.

This commit fixes a bug in parsing indented literal blocks. For example:

test(8)

	```
	This is a block
	```

Prior to this commit, this would fail, but with an unexpected error
message: "Error at 4:3: Cannot deindent in literal block". The
indentation was being parsed at every character, so the parser saw the
`T`, then parsed indentation again. The indentation was 0 (since there
were no tab characters between the `T` and the `h`), but the block
started with an indentation level of 1. 0 < 1, so this would be
considered a dedent, which is not allowed.

This commit introduces a new local variable, `check_indent`, which
controls whether the parser tries to parse indentation or not; now
indentation is only parsed when the last character was a newline. From
my testing this seems to fix the issue - indented literal blocks are now
allowed.

This local variable was initialized to `false` and never set to true
anywhere in the function.

Allow multi-step indentation in literal blocks, and allow multi-step
dedents.

This reverts commit 8c537aa2.

This commit makes using invalid characters in the name a fatal error.
Before this patch, "foo | bar(1)" would parse as "foobar(1)". Now it is
a fatal error and parsing stops.

The test produced the following output:
Ignores underscores in underlined words test/inline-formatting: line 26: end0: not found

On DragonFly, FreeBSD and NetBSD -Dm644 treats m644 as destdir, so
install(1) keeps executable bit on manpages and pkg-config file.

$ make -s install DESTDIR=/tmp/foo
$ find /tmp/foo -type f -ls | awk '{ print $3, $NF }'
-rwxr-xr-x /tmp/foo/usr/local/bin/scdoc
-rwxr-xr-x /tmp/foo/usr/local/lib/pkgconfig/scdoc.pc
-rwxr-xr-x /tmp/foo/usr/local/share/man/man5/scdoc.5
-rwxr-xr-x /tmp/foo/usr/local/share/man/man1/scdoc.1

Fixes https://todo.sr.ht/~sircmpwn/scdoc/23

In the underscore case, the next character is retrieved to check
whether the underscore is at a word break. However, if this character
is UTF8_INVALID, the call to parser_pushch will be a noop. This
results in the loop continuing on further than it should. This just
adds a check to see if next is UTF8_INVALID and returns if it is.
Signed-off-by: Brian Ashworth <bosrsf04@gmail.com>

Currently, the first underscore encountered while underlining ends
underlining. As a result, underscores in underlined words are not
ignored e.g. _hello_world_ does not parse correctly.

This checks the next character to see if it is still in a word before
ending underlining.

The localtime() function gives the time relative to the users time.
This makes the generated manpage non reproducible. gmtime() gives
the time as UTC.