google / google/shaderc

Asciidoctor cannot convert glslc/README.asciidoc to manpage

Open
#1,266 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
C++
Stars
2.2k
Forks
445
Avg merge
11h 6m
Merged PRs (30d)
6

Description

Hello,

When packaging shaderc for Debian, I noticed asciidoctor fails to convert glslc/README.asciidoc to the manpage format:
```
asciidoctor -b manpage glslc/README.asciidoc -o glslc.1
asciidoctor: ERROR: README.asciidoc: line 1: non-conforming manpage title
```
Indeed, according to the [documentation](https://docs.asciidoctor.org/asciidoctor/latest/manpage-backend/#doctype) (*Document Header*), the first line of glslc/README.asciidoc should be:
```
= glslc(1)
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.