Package: caca-utils
Version: 0.99.beta20-6
Severity: wishlist

Dear Maintainer,

I have prepared a simple manpage for the `cacaclock' program in
caca-utils. I wrote the manpage using Emacs Org mode, and exported it
using ox-man.

Both the source in Org mode and the generated `cacaclock.1' file are
attached.

-- System Information:
Debian Release: forky/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (200, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 6.19.8+deb14-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages caca-utils depends on:
ii  libc6         2.42-13
ii  libcaca0      0.99.beta20-6
ii  libimlib2t64  1.12.6-1

Versions of packages caca-utils recommends:
ii  toilet  0.3-5

caca-utils suggests no packages.

-- no debconf information

-- 
Regards,
Xiyue Deng
#+TITLE: cacaclock
#+MAN_CLASS_OPTIONS: :section-id 1

* NAME

cacaclock - Display current time in text mode

* SYNOPSIS

*cacaclock* [OPTIONS]...

* DESCRIPTION

*cacaclock* displays the current digital time under a terminal in text
format. It supports customizing the font and the time format.

* OPTIONS

- *-f, --font=FONT* :: Specify a font for displaying the digital time.
  Supports figfont format fonts with extensions .flf and .tlf.
- *-d, --dateformat=FORMAT* :: Specify a format specification for the
  digital time output. The format follows the strftime(3) conversion
  specification. The default specification is "%R:%S".
- *-v, --version* :: Prints the version of the program.
- *-h, --help* :: Prints help information.

* EXAMPLES

The following command shows an example to display RFC 2822-compliant
date format using cacaclock with the corresponding strftime(3)
specification:

#+BEGIN_EXAMPLE
$ cacaclock -d "%a, %d %b %Y %T %z"
#+END_EXAMPLE

* AUTHOR
Written by Xiyue Deng <[email protected]>.
.TH "cacaclock" "1" 
.SH "NAME"
.PP
cacaclock - Display current time in text mode
.SH "SYNOPSIS"
.PP
\fBcacaclock\fP [OPTIONS]...
.SH "DESCRIPTION"
.PP
\fBcacaclock\fP displays the current digital time under a terminal in text
format. It supports customizing the font and the time format.
.SH "OPTIONS"
.TP
\fB\fB-f, --font=FONT\fP\fP
Specify a font for displaying the digital time.
Supports figfont format fonts with extensions .flf and .tlf.
.TP
\fB\fB-d, --dateformat=FORMAT\fP\fP
Specify a format specification for the
digital time output. The format follows the strftime(3) conversion
specification. The default specification is "%R:%S".
.TP
\fB\fB-v, --version\fP\fP
Prints the version of the program.
.TP
\fB\fB-h, --help\fP\fP
Prints help information.
.SH "EXAMPLES"
.PP
The following command shows an example to display RFC 2822-compliant
date format using cacaclock with the corresponding strftime(3)
specification:

.RS
.nf
$ cacaclock -d "%a, %d %b %Y %T %z"

.fi
.RE
.SH "AUTHOR"
.PP
Written by Xiyue Deng <[email protected]>.

Attachment: signature.asc
Description: PGP signature

Reply via email to