From 275743751cc0ce2914ae1958926ff569dceea6c3 Mon Sep 17 00:00:00 2001 From: Johannes Löthberg Date: Sun, 18 Jan 2015 21:22:51 +0100 Subject: man: Add initial sds(3) manpage --- Makefile | 19 +++++++++++++++++-- docs/conf.py | 17 +++++++++++++++++ docs/sds.rst | 8 ++++++++ 3 files changed, 42 insertions(+), 2 deletions(-) create mode 100644 docs/conf.py create mode 100644 docs/sds.rst diff --git a/Makefile b/Makefile index ef08973..2582aa9 100644 --- a/Makefile +++ b/Makefile @@ -3,12 +3,27 @@ CC = clang SOURCES = src/twbctf.c src/sds.c HEADERS = src/twbctf.h src/sds.h +MANPAGES = docs/sds.3 + +all: sds-test $(MANPAGES) -all: sds-test sds-test: $(SOURCES) $(HEADERS) src/test.c + @echo "==> Building sds-test" $(CC) $(CFLAGS) -o $@ $(SOURCES) - @echo ">>> Type ./sds-test to run the sds.c unit tests." + +docs/%.3: docs/%.rst + @echo "==> Building manpages" + sphinx-build -b man -E docs/ docs/ + + +test: sds-test + ./sds-test + clean: rm -f sds-test + rm docs/*.3 + + +.PHONY: all test diff --git a/docs/conf.py b/docs/conf.py new file mode 100644 index 0000000..8d79a11 --- /dev/null +++ b/docs/conf.py @@ -0,0 +1,17 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- + +project = 'SDS' +master_doc = 'sds' +source_suffix = '.rst' + +show_authors = False +today_fmt = '%d %b %Y' + +# One entry per manual page. List of tuples +# (source start file, name, description, authors, manual section). +man_pages = [ + ('sds', 'sds', 'Simple Dynamic String library for C', [], 3), + ('sdsnew', 'sdsnew', 'Create a new SDS string', [], 3), + ('sdsfree', 'sdsfree', 'Free an SDS string', [], 3), +] diff --git a/docs/sds.rst b/docs/sds.rst new file mode 100644 index 0000000..7dd17d0 --- /dev/null +++ b/docs/sds.rst @@ -0,0 +1,8 @@ +:orphan: + +sds +=== + +Functions +--------- + -- cgit v1.2.3-54-g00ecf