Browse Source

Merge pull request #12158 from Chocobo1/man

Add man page files in Markdown format
adaptive-webui-19844
Mike Tzou 5 years ago committed by GitHub
parent
commit
8e553adc92
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 20
      doc/README.md
  2. 89
      doc/qbittorrent-nox.1
  3. 41
      doc/qbittorrent-nox.1.md
  4. 79
      doc/qbittorrent.1
  5. 36
      doc/qbittorrent.1.md

20
doc/README.md

@ -0,0 +1,20 @@
qBittorent man pages
===
Our man pages are written in Markdown format (.md) and we use [Pandoc](https://pandoc.org/) to
convert them to roff (the man page format).
Refer to [Pandoc's Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown) for info
on that specific format.
To build the man pages:
```shell
pandoc -s -f markdown -t man qbittorrent.1.md -o qbittorrent.1
pandoc -s -f markdown -t man qbittorrent-nox.1.md -o qbittorrent-nox.1
```
There is also an online converter you can use if you have trouble installing a
local one: [link](https://pandoc.org/try/?text=&from=markdown&to=man) \
You'll need to be careful when you copy the output to file as some headers will be missing.
Careful not to overwrite the existing leading headers or trim off the trailing headers.
Remember to commit Markdown files (\*.md) and the generated man pages (\*.1 files) after editing!

89
doc/qbittorrent-nox.1

@ -1,44 +1,47 @@
.\" This manpage has been automatically generated by docbook2man .\" Automatically generated by Pandoc 2.9.2
.\" from a DocBook document. This tool can be found at: .\"
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>. .TH "QBITTORRENT-NOX" "1" "January 16th 2010" "Command line Bittorrent client written in C++ / Qt" ""
.TH "QBITTORRENT\-NOX" "1" "January 16th 2010" "Command line Bittorrent client written in C++ / Qt" "" .hy
.SH NAME
.SH "NAME" .PP
qBittorrent\-nox \- a command line Bittorrent client written in C++ / Qt qBittorrent-nox - a command line Bittorrent client written in C++ / Qt
.SH SYNOPSIS
.SH "SYNOPSIS" .PP
\f[B]qbittorrent-nox\f[R]
\fBqbittorrent\-nox\fR [\-\-d|\-\-daemon] [\-\-webui-port=x] [TORRENT_FILE | URL]... \f[C][--d|--daemon] [--webui-port=x] [TORRENT_FILE | URL]...\f[R]
.PP
\fBqbittorrent\-nox\fR \-\-help \f[B]qbittorrent-nox\f[R] \f[C]--help\f[R]
.PP
\fBqbittorrent\-nox\fR \-\-version \f[B]qbittorrent-nox\f[R] \f[C]--version\f[R]
.SH DESCRIPTION
.PP .PP
.SH "DESCRIPTION" \f[B]qBittorrent-nox\f[R] is an advanced command-line Bittorrent client
written in C++ / Qt using the \f[B]libtorrent-rasterbar\f[R] library by
\fBqBittorrent-nox\fR is an advanced command-line Bittorrent client written in C++ / Qt Arvid Norberg.
using the \fBlibtorrent-rasterbar\fR library by Arvid Norberg. qBittorrent\-nox aims qBittorrent-nox aims to be a good alternative to other command line
to be a good alternative to other command line bittorrent clients and provides features similar to popular graphical clients. bittorrent clients and provides features similar to popular graphical
clients.
qBittorrent\-nox is fast, stable, light and it supports unicode. .PP
It also comes with UPnP port forwarding / NAT-PMP, encryption (Vuze compatible), qBittorrent-nox is fast, stable, light and it supports unicode.
FAST extension (mainline) and PeX support (utorrent compatible). It also comes with UPnP port forwarding / NAT-PMP, encryption (Vuze
compatible), FAST extension (mainline) and PeX support (utorrent
qBittorrent\-nox is meant to be controlled via its feature-rich Web UI which is accessible as a default on http://localhost:8080. The Web UI access is secured and the default account user name is "admin" with "adminadmin" as a password. compatible).
.PP
.SH "OPTIONS" qBittorrent-nox is meant to be controlled via its feature-rich Web UI
which is accessible as a default on http://localhost:8080.
\fB--help\fR Prints the command line options. The Web UI access is secured and the default account user name is
\[lq]admin\[rq] with \[lq]adminadmin\[rq] as a password.
\fB--version\fR Prints qbittorrent program version number. .SH OPTIONS
.PP
\fB--webui-port=x\fR Changes Web UI port to x (default: 8080). \f[B]\f[CB]--help\f[B]\f[R] Prints the command line options.
.PP
.SH "BUGS" \f[B]\f[CB]--version\f[B]\f[R] Prints qbittorrent program version
number.
.PP
\f[B]\f[CB]--webui-port=x\f[B]\f[R] Changes Web UI port to x (default:
8080).
.SH BUGS
.PP
If you find a bug, please report it at http://bugs.qbittorrent.org If you find a bug, please report it at http://bugs.qbittorrent.org
.SH AUTHORS
.SH "AUTHOR" Christophe Dumez <chris@qbittorrent.org>.
Christophe Dumez <chris@qbittorrent.org>

41
doc/qbittorrent-nox.1.md

@ -0,0 +1,41 @@
% QBITTORRENT-NOX(1) Command line Bittorrent client written in C++ / Qt
% Christophe Dumez <chris@qbittorrent.org>
% January 16th 2010
# NAME
qBittorrent-nox - a command line Bittorrent client written in C++ / Qt
# SYNOPSIS
**qbittorrent-nox** `[--d|--daemon] [--webui-port=x] [TORRENT_FILE | URL]...`
**qbittorrent-nox** `--help`
**qbittorrent-nox** `--version`
# DESCRIPTION
**qBittorrent-nox** is an advanced command-line Bittorrent client written in C++ / Qt
using the **libtorrent-rasterbar** library by Arvid Norberg.
qBittorrent-nox aims to be a good alternative to other command line bittorrent
clients and provides features similar to popular graphical clients.
qBittorrent-nox is fast, stable, light and it supports unicode. It also comes with
UPnP port forwarding / NAT-PMP, encryption (Vuze compatible), FAST extension (mainline)
and PeX support (utorrent compatible).
qBittorrent-nox is meant to be controlled via its feature-rich Web UI which is
accessible as a default on http://localhost:8080. The Web UI access is secured and
the default account user name is "admin" with "adminadmin" as a password.
# OPTIONS
**`--help`** Prints the command line options.
**`--version`** Prints qbittorrent program version number.
**`--webui-port=x`** Changes Web UI port to x (default: 8080).
# BUGS
If you find a bug, please report it at http://bugs.qbittorrent.org

79
doc/qbittorrent.1

@ -1,42 +1,41 @@
.\" This manpage has been automatically generated by docbook2man .\" Automatically generated by Pandoc 2.9.2
.\" from a DocBook document. This tool can be found at: .\"
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>.
.TH "QBITTORRENT" "1" "January 16th 2010" "Bittorrent client written in C++ / Qt" "" .TH "QBITTORRENT" "1" "January 16th 2010" "Bittorrent client written in C++ / Qt" ""
.hy
.SH "NAME" .SH NAME
qBittorrent \- a Bittorrent client written in C++ / Qt .PP
qBittorrent - a Bittorrent client written in C++ / Qt
.SH "SYNOPSIS" .SH SYNOPSIS
.PP
\fBqbittorrent\fR [\-\-no-splash] [\-\-webui-port=x] [TORRENT_FILE | URL]... \f[B]qbittorrent\f[R]
\f[C][--no-splash] [--webui-port=x] [TORRENT_FILE | URL]...\f[R]
\fBqbittorrent\fR \-\-help .PP
\f[B]qbittorrent\f[R] \f[C]--help\f[R]
\fBqbittorrent\fR \-\-version .PP
\f[B]qbittorrent\f[R] \f[C]--version\f[R]
.PP .SH DESCRIPTION
.SH "DESCRIPTION" .PP
\f[B]qBittorrent\f[R] is an advanced Bittorrent client written in C++ /
\fBqBittorrent\fR is an advanced Bittorrent client written in C++ / Qt, Qt, using the \f[B]libtorrent-rasterbar\f[R] library by Arvid Norberg.
using the \fBlibtorrent-rasterbar\fR library by Arvid Norberg. qBittorrent is similar to uTorrent. qBittorrent qBittorrent is similar to uTorrent.
is fast, stable, light, it supports unicode and it provides a good integrated search engine. qBittorrent is fast, stable, light, it supports unicode and it provides
It also comes with UPnP port forwarding / NAT-PMP, encryption (Vuze compatible), a good integrated search engine.
FAST extension (mainline) and PeX support (utorrent compatible). It also comes with UPnP port forwarding / NAT-PMP, encryption (Vuze
compatible), FAST extension (mainline) and PeX support (utorrent
.SH "OPTIONS" compatible).
.SH OPTIONS
\fB--help\fR Prints the command line options. .PP
\f[B]\f[CB]--help\f[B]\f[R] Prints the command line options.
\fB--version\fR Prints qbittorrent program version number. .PP
\f[B]\f[CB]--version\f[B]\f[R] Prints qbittorrent program version
\fB--no-splash\fR Disables splash screen on startup. number.
.PP
\fB--webui-port=x\fR Changes Web UI port to x (default: 8080). \f[B]\f[CB]--no-splash\f[B]\f[R] Disables splash screen on startup.
.PP
.SH "BUGS" \f[B]\f[CB]--webui-port=x\f[B]\f[R] Changes Web UI port to x (default:
8080).
.SH BUGS
.PP
If you find a bug, please report it at http://bugs.qbittorrent.org If you find a bug, please report it at http://bugs.qbittorrent.org
.SH AUTHORS
.SH "AUTHOR" Christophe Dumez <chris@qbittorrent.org>.
Christophe Dumez <chris@qbittorrent.org>

36
doc/qbittorrent.1.md

@ -0,0 +1,36 @@
% QBITTORRENT(1) Bittorrent client written in C++ / Qt
% Christophe Dumez <chris@qbittorrent.org>
% January 16th 2010
# NAME
qBittorrent - a Bittorrent client written in C++ / Qt
# SYNOPSIS
**qbittorrent** `[--no-splash] [--webui-port=x] [TORRENT_FILE | URL]...`
**qbittorrent** `--help`
**qbittorrent** `--version`
# DESCRIPTION
**qBittorrent** is an advanced Bittorrent client written in C++ / Qt,
using the **libtorrent-rasterbar** library by Arvid Norberg. qBittorrent is similar to uTorrent.
qBittorrent is fast, stable, light, it supports unicode and it provides a good integrated
search engine. It also comes with UPnP port forwarding / NAT-PMP, encryption (Vuze compatible),
FAST extension (mainline) and PeX support (utorrent compatible).
# OPTIONS
**`--help`** Prints the command line options.
**`--version`** Prints qbittorrent program version number.
**`--no-splash`** Disables splash screen on startup.
**`--webui-port=x`** Changes Web UI port to x (default: 8080).
# BUGS
If you find a bug, please report it at http://bugs.qbittorrent.org
Loading…
Cancel
Save