From 4cad20a5768d3dad8c4e79f49727416d30b5783e Mon Sep 17 00:00:00 2001 From: Teddy Wing Date: Wed, 5 May 2021 01:54:20 +0200 Subject: Add man page --- Makefile | 8 +++++ doc/pdf-form-replace-font.1 | 65 +++++++++++++++++++++++++++++++++++++++++ doc/pdf-form-replace-font.1.txt | 36 +++++++++++++++++++++++ 3 files changed, 109 insertions(+) create mode 100644 Makefile create mode 100644 doc/pdf-form-replace-font.1 create mode 100644 doc/pdf-form-replace-font.1.txt diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..177d7fe --- /dev/null +++ b/Makefile @@ -0,0 +1,8 @@ +MAN_PAGE := doc/pdf-form-replace-font.1 + + +.PHONY: doc +doc: $(MAN_PAGE) + +$(MAN_PAGE): $(MAN_PAGE).txt + a2x --no-xmllint --format manpage $< diff --git a/doc/pdf-form-replace-font.1 b/doc/pdf-form-replace-font.1 new file mode 100644 index 0000000..0024c30 --- /dev/null +++ b/doc/pdf-form-replace-font.1 @@ -0,0 +1,65 @@ +'\" t +.\" Title: pdf-form-replace-font +.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] +.\" Generator: DocBook XSL Stylesheets v1.79.1 +.\" Date: 05/05/2021 +.\" Manual: \ \& +.\" Source: \ \& +.\" Language: English +.\" +.TH "PDF\-FORM\-REPLACE\-" "1" "05/05/2021" "\ \&" "\ \&" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +pdf-form-replace-font \- Replace a font in a PDF form +.SH "SYNOPSIS" +.sp +\fBpdf\-form\-replace\-font\fR \-\-fill \fIoriginal_font\fR \-\-replace \fIreplacement_font\fR [options] [\fIpdf_file\fR] +.SH "DESCRIPTION" +.sp +Replace a font used in the input PDF\(cqs text form fields\&. If no input path is given, the PDF will be read from standard input\&. +.sp +Given a PostScript font name used in text fields in the input PDF, those fields will be changed to use the replacement typeface\&. +.SH "OPTIONS" +.PP +\-f, \-\-find +.RS 4 +PostScript name of the font that will be replaced\&. +.RE +.PP +\-r, \-\-replace +.RS 4 +PostScript name of the replacement font\&. +.RE +.PP +\-o, \-\-output +.RS 4 +The output PDF path\&. If this option is not given, or if the value is given as "\-", the PDF will output to standard output\&. +.RE +.PP +\-h, \-\-help +.RS 4 +Print usage help\&. +.RE +.PP +\-V, \-\-version +.RS 4 +Print the program version\&. +.RE diff --git a/doc/pdf-form-replace-font.1.txt b/doc/pdf-form-replace-font.1.txt new file mode 100644 index 0000000..3ac4b45 --- /dev/null +++ b/doc/pdf-form-replace-font.1.txt @@ -0,0 +1,36 @@ +pdf-form-replace-font(1) +======================== + +NAME +---- +pdf-form-replace-font - Replace a font in a PDF form + +SYNOPSIS +-------- +*pdf-form-replace-font* --fill 'original_font' --replace 'replacement_font' [options] ['pdf_file'] + +DESCRIPTION +----------- +Replace a font used in the input PDF's text form fields. If no input path is +given, the PDF will be read from standard input. + +Given a PostScript font name used in text fields in the input PDF, those +fields will be changed to use the replacement typeface. + +OPTIONS +------- +-f, --find:: + PostScript name of the font that will be replaced. + +-r, --replace:: + PostScript name of the replacement font. + +-o, --output:: + The output PDF path. If this option is not given, or if the value is given + as "-", the PDF will output to standard output. + +-h, --help:: + Print usage help. + +-V, --version:: + Print the program version. -- cgit v1.2.3