olddoc.git  about / heads / tags
olddoc - old-fashioned RDoc generator(s)
blob 994a867e3f26b9f98b6ce3898b1f4bca3311cf1d 1001 bytes (raw)
$ git show HEAD:Documentation/olddoc.5.pod	# shows this blob on the CLI

 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
34
35
 
=head1 NAME

.olddoc.yml - olddoc config file format

=head1 SYNOPSIS

A YAML file in the top-level project directory named ".olddoc.yml"

=head1 DESCRIPTION

As olddoc favors consistency over configuration, there is minimal
configuration to deal with.

=head1 KEYS

`rdoc_url`, `cgit_url`, `imap_url`, and `nntp_url` should be obvious

`merge_html` is a key-value mapping of (empty) RDoc source files to an
HTML file that will be merged into RDoc after-the-fact.  It is useful
for merging non-RDoc generated HTML into the project.

`ml_url` is the mail archive location.
`public_email` is the email address of a mail archived at `ml_url`

As of olddoc 1.2.0, `ml_url` and `nntp_url` may be YAML arrays
with multiple URLs.

As of olddoc 1.3.0, the `source_code` array may be any number of
commands or URLs.  This allows users of arbitrary version
control systems to specify instructions for getting the code
and not assume users are familiar with any particular system.

=head1 SEE ALSO

L<olddoc(1)>

git clone https://80x24.org/olddoc.git