File: README.md

package info (click to toggle)
libtext-markdown-discount-perl 0.18-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 1,524 kB
  • sloc: ansic: 5,765; pascal: 1,027; sh: 208; makefile: 196; perl: 184
file content (33 lines) | stat: -rw-r--r-- 1,350 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# *Discount* Markdown compiler on Plan 9

## Build
    % CONFIG='--with-tabstops=7' mk config
    % mk test
    % mk install
    % markdown -V
    markdown: discount X.Y.Z TAB=7

### Configuration
To select features and extensions, `--with-tabstops=7` may be replaced by zero or more of:

* `--enable-pandoc-header`:  Use pandoc-style header blocks
* `--enable-superscript`:  `A^B` becomes A<sup>B</sup>
* `--enable-amalloc`:  Enable memory allocation debugging
* `--with-tabstops=`*N*:  Set tabstops to *N* characters (default 4)
* `--enable-alpha-list`:  Enable `(a)/(b)/(c)` list markers
* `--enable-all-features`:  Turn on all stable optional features

## Notes
1. This is not a port from POSIX to native Plan 9 APIs. The supplied
`mkfile` merely drives Discount's own `configure.sh` through Plan 9's
*APE* environment (in *pcc*(1)) to build the Discount source, then
copies the result to locations appropriate for system-wide use on
Plan 9.

2. There are a few other *mk*(1) targets:
    * `install.libs`:  Discount includes a C library and header.
Installation is optional.  Plan 9 binaries are statically linked.
    * `install.man`:  Add manual pages for *markdown* in sections 1, 2, and 6.
    * `install.progs`:  Extra programs.  *makepage* writes complete XHTML
documents, rather than fragments.  *mkd2html* is similar, but produces
HTML.