summary refs log tree commit diff stats
path: root/draco.1
blob: d68912b64b0164291c5db25052c726b1563005aa (plain) (blame)
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
36
37
38
39
40
.Dd $Mdocdate: November 19 2020 $
.Dt DRACO 1
.Os
.Sh NAME
.Nm draco
.Nd a script to convert reddit thread to Org document
.Sh SYNOPSIS
.Nm draco
.Op Fl dv
.Ar <url>
.Sh DESCRIPTION
.Nm
is a script to convert reddit thread to Org document. It accepts a url
& prints the Org document to STDOUT.

It'll also print comments along with their replies. It's limited by
the reddit API.

The options are as follows:
.Bl -tag -width Ds
.It Fl d
Turn on debug messages. Debug messages will be printed to STDERR.
.It Fl v
Print version.
.Pp
.Sh NOTES
Draco will add 2 spaces before every new line. Comments/Posts may
contain `*' at the start of line & that confuses Org. Org might
interpret it as a new heading so we add a space before every new line.

All text will be wrapped at 76 characters, including 2 spaces before
every new line the maximum number of columns becomes 78.
.Pp
.Sh WHY?
I reference things from the web in my Journal & don't want those links
to break so I save them locally. Previously I used to manually archive
the whole thread, this automates it.
.Pp
.Sh AUTHOR
.An Andinus Aq Mt andinus@nand.sh