aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2008-12-07 23:08:23 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2008-12-07 23:08:23 +0000
commit97ce52b73db0ab7a5fc1b915e913624b2531f9ca (patch)
tree3368c8429d57a18b278853a4c2968b6807f9f574
parent2c06cb42dbd9c2e387346dd955aa0ca588f19586 (diff)
downloadmandoc-97ce52b73db0ab7a5fc1b915e913624b2531f9ca.tar.gz
mandoc-97ce52b73db0ab7a5fc1b915e913624b2531f9ca.tar.zst
mandoc-97ce52b73db0ab7a5fc1b915e913624b2531f9ca.zip
*** empty log message ***
-rw-r--r--Makefile21
-rw-r--r--index.744
-rw-r--r--mdocml.14
3 files changed, 53 insertions, 16 deletions
diff --git a/Makefile b/Makefile
index c012571c..d842dd9c 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,8 @@
.SUFFIXES: .html .7
+VERSION = 1.0.0
+
+# FIXME
CFLAGS += -W -Wall -Wno-unused-parameter -g -DDEBUG
LINTFLAGS += -c -e -f -u
@@ -16,9 +19,9 @@ SRCS = mdocml.c html.c xml.c libmdocml.c roff.c ml.c mlg.c compat.c tokens.c lit
HEADS = libmdocml.h private.h ml.h roff.h
-MANS = mdocml.1
+MANS = mdocml.1 index.7
-HTML = index.html
+HTML = index.html mdocml.html
CLEAN = mdocml mdocml.tgz $(LLNS) $(LNS) $(OBJS) $(LIBS) $(HTML)
@@ -35,7 +38,6 @@ SUCCEED = test.7 test.8 test.9 test.10 test.11 test.12 test.13 \
test.45 test.46 test.47 test.48 test.49 test.51 test.52 \
test.54 test.55 test.56 test.57 test.58 test.59 test.60
-
all: mdocml
lint: llib-lmdocml.ln
@@ -63,10 +65,17 @@ clean:
index.html: index.7 mdocml.css
./mdocml -W -fhtml -e -o $@ index.7
+mdocml.html: mdocml.1 mdocml.css
+ ./mdocml -W -fhtml -e -o $@ mdocml.1
+
+install-www: www dist
+ install -m 0644 mdocml.tgz $(PREFIX)/
+ install -m 0644 $(HTML) $(PREFIX)/
+
mdocml.tgz: $(INSTALL)
- mkdir -p .dist/mdocml/
- install -m 0644 $(INSTALL) .dist/mdocml/
- ( cd .dist/ && tar zcf ../mdocml.tgz mdocml/ )
+ mkdir -p .dist/mdocml/mdocml-$(VERSION)/
+ install -m 0644 $(INSTALL) .dist/mdocml/mdocml-$(VERSION)/
+ ( cd .dist/mdocml/ && tar zcf ../mdocml.tgz mdocml-$(VERSION)/ )
rm -rf .dist/
llib-lmdocml.ln: mdocml.ln libmdocml.ln html.ln xml.ln roff.ln ml.ln mlg.ln compat.ln tokens.ln literals.ln
diff --git a/index.7 b/index.7
index d696df60..3baf4304 100644
--- a/index.7
+++ b/index.7
@@ -52,6 +52,18 @@ or
.It
and so on.
.El
+.Pp
+The
+.Nm
+utility has been tested under Linux and
+.Ox ,
+specifically on
+.Ox
+manual source.
+.Nm
+is
+.Ud
+.\"
.Ss Filtering
When a block of source has been verified, it's passed to the front-end
fitlers, which format and display data. The
@@ -59,6 +71,7 @@ fitlers, which format and display data. The
utility is invoked with a filter by the
.Fl f
flag. The HTML filter has the following features:
+.Pp
.Bl -enum -compact
.It
HTML-4.01 strict compliance.
@@ -67,19 +80,34 @@ Proper render of values in UTF-8, such as
.Dq quotes
and \*(>= predefined values.
.It
-URI-appearing http://bsd.lv strings are correctly enclosed in link tags.
+URI-appearing http://bsd.lv/ strings are correctly enclosed in link tags.
.It
CSS-dictated style with meaningful non-CSS defaults.
.El
+.Pp
+The XML filter creates a correct XML tree with
+.Dq block ,
+.Dq head ,
+.Dq body ,
+and
+.Dq inline
+namespaces corresponding to macro categories. Namespace identifiers
+correspond to their definitions.
.\"
-.Sh ENVIRONMENT
-The
+.Sh DOWNLOADS
+Download
.Nm
-utility has been tested under Linux and
-.Ox ,
-specifically on
-.Ox
-manual source.
+at http://mdocml.bsd.lv/mdocml.tgz
+.Ns .
+.\" - UPDATE ME WITH EVERY RELEASE. ----------------------------------
+The current version is 1.0.0, dated 08/12/2008.
+.\" ------------------------------------------------------------------
+.\"
+.Sh DOCUMENTS
+The manual for
+.Nm
+is available at http://mdocml.bsd.lv/mdocml.html
+.Ns .
.\"
.Sh EXAMPLES
This page was produced as follows:
diff --git a/mdocml.1 b/mdocml.1
index 31fd863a..547d160e 100644
--- a/mdocml.1
+++ b/mdocml.1
@@ -1,5 +1,5 @@
.\"
-.Dd $Mdocdate: December 6 2008 $
+.Dd $Mdocdate: December 7 2008 $
.Dt mdocml 1 alpha
.Os
.\"
@@ -118,7 +118,7 @@ and
The
.Nm
utility was written by
-.An Em Kristaps Dzonsons Aq kristaps@kth.se .
+.An Kristaps Dzonsons Aq kristaps@kth.se .
.\"
.Sh CAVEATS
Most caveats of