From faab1d055d8c033b5975727a4de7431d548b7db2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Lyson=C4=9Bk?= <olysonek@redhat.com>
Date: Tue, 26 Jun 2018 15:07:43 +0200
Subject: [PATCH] Use kramdown in man pages
---
Makefile.am | 20 +++----
README.md | 4 +-
configure.ac | 8 ---
src/espeak-ng.1.md | 163 +++++++++++++++++++++++++++++++++++++++++++++++++++
src/espeak-ng.1.ronn | 162 --------------------------------------------------
src/speak-ng.1.md | 159 +++++++++++++++++++++++++++++++++++++++++++++++++
src/speak-ng.1.ronn | 158 -------------------------------------------------
7 files changed, 331 insertions(+), 343 deletions(-)
create mode 100644 src/espeak-ng.1.md
delete mode 100644 src/espeak-ng.1.ronn
create mode 100644 src/speak-ng.1.md
delete mode 100644 src/speak-ng.1.ronn
diff --git a/Makefile.am b/Makefile.am
index 0ae0c326..cf1d833e 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -76,14 +76,14 @@ distclean-local:
##### custom rules:
-SUFFIXES=.html .md .ronn
+SUFFIXES=.html .md
.md.html: _layouts/webpage.html
- cat $< | sed -e 's/\.md)/.html)/g' -e 's/\.ronn/.html/g' | \
+ cat $< | sed -e 's/\.md)/.html)/g' | \
kramdown --template _layouts/webpage.html > $@
-.ronn.html:
- ronn --html $<
+.md.html:
+ kramdown --template _layouts/webpage.html -i kramdown -o html $< > $@
##### vim:
@@ -101,11 +101,11 @@ EXTRA_DIST += $(vim_addons_syntax_DATA)
##### documentation:
-src/espeak-ng.1: src/espeak-ng.1.ronn
- ronn --roff $<
+src/espeak-ng.1: src/espeak-ng.1.md
+ kramdown -i kramdown -o man $< > $@
-src/speak-ng.1: src/speak-ng.1.ronn
- ronn --roff $<
+src/speak-ng.1: src/speak-ng.1.md
+ kramdown -i kramdown -o man $< > $@
docs: docs/index.html \
docs/add_language.html \
@@ -195,9 +195,7 @@ endif
bin_PROGRAMS += src/speak-ng
-if HAVE_RONN
man1_MANS += src/speak-ng.1
-endif
src_speak_ng_LDADD = src/libespeak-ng.la
src_speak_ng_LDFLAGS = -static -lm ${PCAUDIOLIB_LIBS}
@@ -206,9 +204,7 @@ src_speak_ng_SOURCES = src/speak-ng.c
bin_PROGRAMS += src/espeak-ng
-if HAVE_RONN
man1_MANS += src/espeak-ng.1
-endif
src_espeak_ng_LDADD = src/libespeak-ng.la ${PCAUDIOLIB_LIBS}
src_espeak_ng_SOURCES = src/espeak-ng.c
diff --git a/README.md b/README.md
index dac80c21..935fe977 100644
--- a/README.md
+++ b/README.md
@@ -108,7 +108,6 @@ Optionally, you need:
to enable audio output;
3. the [sonic](https://github.com/espeak-ng/sonic) development library to
enable sonic audio speed up support;
-4. the `ronn` man-page markdown processor to build the man pages.
To build the documentation, you need:
@@ -122,7 +121,6 @@ be installed using the following commands:
| autotools | `sudo apt-get install make autoconf automake libtool pkg-config` |
| c99 compiler | `sudo apt-get install gcc` |
| sonic | `sudo apt-get install libsonic-dev` |
-| ronn | `sudo apt-get install ruby-ronn` |
| kramdown | `sudo apt-get install ruby-kramdown` |
### Building
@@ -326,7 +324,7 @@ To enable eSpeak, you need to:
The [main documentation](docs/index.md) for eSpeak NG provides more information
on using and creating voices/languages for eSpeak NG.
-The [espeak-ng](src/espeak-ng.1.ronn) and [speak-ng](src/speak-ng.1.ronn)
+The [espeak-ng](src/espeak-ng.1.md) and [speak-ng](src/speak-ng.1.md)
command-line documentation provide a reference of the different command-line
options available to these commands with example usage.
diff --git a/configure.ac b/configure.ac
index 33960c24..302f88f4 100644
--- a/configure.ac
+++ b/configure.ac
@@ -223,14 +223,6 @@ AM_CONDITIONAL(OPT_KLATT, [test x"$have_klatt" = xyes])
AM_CONDITIONAL(OPT_MBROLA, [test x"$have_mbrola" = xyes])
AM_CONDITIONAL(OPT_ASYNC, [test x"$have_async" = xyes])
-dnl ================================================================
-dnl ronn checks.
-dnl ================================================================
-
-AC_CHECK_PROG(RONN, ronn, ronn, no)
-
-AM_CONDITIONAL(HAVE_RONN, [test ! x"$RONN" = xno])
-
dnl ================================================================
dnl Extended dictionary checks.
dnl ================================================================
diff --git a/src/espeak-ng.1.md b/src/espeak-ng.1.md
new file mode 100644
index 00000000..89fa2c01
--- /dev/null
+++ b/src/espeak-ng.1.md
@@ -0,0 +1,163 @@
+# espeak-ng(1) - A multi-lingual software speech synthesizer.
+{: data-date="July 2018"}
+
+## SYNOPSIS
+
+__espeak-ng__ \[*options*\] \[*words*\]
+
+## DESCRIPTION
+
+__espeak-ng__ is a software speech synthesizer for English, and some other
+languages.
+
+## OPTIONS
+
+`-h`, `--help`
+: Show summary of options.
+
+`--version`
+: Prints the espeak library version and the location of the espeak voice
+ data.
+
+`-f <text file>`
+: Text file to speak.
+
+`--stdin`
+: Read text input from stdin instead of a file.
+
+If neither `-f` nor `--stdin` are provided, `<words>` are spoken, or if no
+words are provided then text is spoken from stdin a line at a time.
+
+`-d <device>`
+: Use the specified device to speak the audio on. If not specified, the
+ default audio device is used.
+
+`-q`
+: Quiet, don't produce any speech (may be useful with `-x`).
+
+`-a <integer>`
+: Amplitude, 0 to 200, default is 100.
+
+`-g <integer>`
+: Word gap. Pause between words, units of 10ms at the default speed.
+
+`-k <integer>`
+: Indicate capital letters with: 1=sound, 2=the word \"capitals\", higher
+ values = a pitch increase (try `-k20`).
+
+`-l <integer>`
+: Line length. If not zero (which is the default), consider lines less than
+ this length as end-of-clause.
+
+`-p <integer>`
+: Pitch adjustment, 0 to 99, default is 50.
+
+`-s <integer>`
+: Speed in words per minute, default is 160.
+
+`-v <voice name>`
+: Use voice file of this name from espeak-ng-data/voices. A variant can be
+ specified using _voice_+_variant_, such as af+m3.
+
+`-w <wave file name>`
+: Write output to this WAV file, rather than speaking it directly.
+
+`--split=<minutes>`
+: Used with `-w` to split the audio output into \<minutes\> recorded
+ chunks.
+
+`-b`
+: Input text encoding, 1=UTF8, 2=8 bit, 4=16 bit.
+
+`-m`
+: Indicates that the text contains SSML (Speech Synthesis Markup Language)
+ tags or other XML tags. Those SSML tags which are supported are
+ interpreted. Other tags, including HTML, are ignored, except that some HTML
+ tags such as \<hr\> \<h2\> and \<li\> ensure a break in the speech.
+
+`-x`
+: Write phoneme mnemonics to stdout.
+
+`-X`
+: Write phonemes mnemonics and translation trace to stdout. If rules files
+ have been built with `--compile=debug`, line numbers will also be displayed.
+
+`-z`
+: No final sentence pause at the end of the text.
+
+`--stdout`
+: Write speech output to stdout.
+
+`--compile=voicename`
+: Compile the pronunciation rules and dictionary in the current directory.
+ =\<voicename\> is optional and specifies which language is compiled.
+
+`--compile-debug=voicename`
+: Compile the pronunciation rules and dictionary in the current directory as
+ above, but include line numbers, that get shown when `-X` is used.
+
+`--ipa`
+: Write phonemes to stdout using International Phonetic Alphabet. `--ipa=1`
+ Use ties, `--ipa=2` Use ZWJ, `--ipa=3` Separate with _.
+
+`--tie=<character>`
+: The character to use to join multi-letter phonemes in `-x` and `--ipa`
+ output.
+
+`--path=<path>`
+: Specifies the directory containing the espeak-ng-data directory.
+
+`--pho`
+: Write mbrola phoneme data (.pho) to stdout or to the file in `--phonout`.
+
+`--phonout=<filename>`
+: Write output from `-x` `-X` commands and mbrola phoneme data to this file.
+
+`--punct="<characters>"`
+: Speak the names of punctuation characters during speaking. If
+ =\<characters\> is omitted, all punctuation is spoken.
+
+`--sep=<character>`
+: The character to separate phonemes from the `-x` and `--ipa` output.
+
+`--voices[=<language code>]`
+: Lists the available voices. If =\<language code\> is present then only
+ those voices which are suitable for that language are listed.
+
+`--voices=<directory>`
+: Lists the voices in the specified subdirectory.
+
+## EXAMPLES
+
+`espeak-ng "This is a test"`
+: Speak the sentence \"This is a test\" using the default English voice.
+
+`espeak-ng -f hello.txt`
+: Speak the contents of hello.txt using the default English voice.
+
+`cat hello.txt | espeak-ng`
+: Speak the contents of hello.txt using the default English voice.
+
+`espeak-ng -x hello`
+: Speak the word \"hello\" using the default English voice, and print the
+ phonemes that were spoken.
+
+`espeak-ng -ven-us "[[h@'loU]]"`
+: Speak the phonemes \"h@'loU\" using the American English voice.
+
+`espeak-ng --voices`
+: List all voices supported by eSpeak.
+
+`espeak-ng --voices=en`
+: List all voices that speak English (`en`).
+
+`espeak-ng --voices=mb`
+: List all voices using the MBROLA voice synthesizer.
+
+## AUTHOR
+
+eSpeak NG is maintained by Reece H. Dunn <msclrhd@gmail.com>. It is based on
+eSpeak by Jonathan Duddington <jonsd@jsd.clara.co.uk>.
+
+This manual page is based on the eSpeak page written by Luke Yelavich
+<themuso@ubuntu.com> for the Ubuntu project.
diff --git a/src/espeak-ng.1.ronn b/src/espeak-ng.1.ronn
deleted file mode 100644
index 4fcd5e87..00000000
--- a/src/espeak-ng.1.ronn
+++ /dev/null
@@ -1,162 +0,0 @@
-# espeak-ng - A multi-lingual software speech synthesizer.
-
-## SYNOPSIS
-
-__espeak-ng__ [<options>] [<words>]
-
-## DESCRIPTION
-
-__espeak-ng__ is a software speech synthesizer for English, and some other
-languages.
-
-## OPTIONS
-
- * `-h`, `--help`:
- Show summary of options.
-
- * `--version`:
- Prints the espeak library version and the location of the espeak voice
- data.
-
- * `-f <text file>`:
- Text file to speak.
-
- * `--stdin`:
- Read text input from stdin instead of a file.
-
-If neither -f nor --stdin are provided, <words> are spoken, or if no
-words are provided then text is spoken from stdin a line at a time.
-
- * `-d <device>`:
- Use the specified device to speak the audio on. If not specified, the
- default audio device is used.
-
- * `-q`:
- Quiet, don't produce any speech (may be useful with -x).
-
- * `-a <integer>`:
- Amplitude, 0 to 200, default is 100.
-
- * `-g <integer>`:
- Word gap. Pause between words, units of 10ms at the default speed.
-
- * `-k <integer>`:
- Indicate capital letters with: 1=sound, 2=the word "capitals", higher
- values = a pitch increase (try -k20).
-
- * `-l <integer>`:
- Line length. If not zero (which is the default), consider lines less than
- this length as end-of-clause.
-
- * `-p <integer>`:
- Pitch adjustment, 0 to 99, default is 50.
-
- * `-s <integer>`:
- Speed in words per minute, default is 160.
-
- * `-v <voice name>`:
- Use voice file of this name from espeak-ng-data/voices. A variant can be
- specified using <voice>+<variant>, such as af+m3.
-
- * `-w <wave file name>`:
- Write output to this WAV file, rather than speaking it directly.
-
- * `--split=<minutes>`:
- Used with `-w` to split the audio output into <minutes> recorded
- chunks.
-
- * `-b`:
- Input text encoding, 1=UTF8, 2=8 bit, 4=16 bit.
-
- * `-m`:
- Indicates that the text contains SSML (Speech Synthesis Markup Language)
- tags or other XML tags. Those SSML tags which are supported are
- interpreted. Other tags, including HTML, are ignored, except that some HTML
- tags such as <hr> <h2> and <li> ensure a break in the
- speech.
-
- * `-x`:
- Write phoneme mnemonics to stdout.
-
- * `-X`:
- Write phonemes mnemonics and translation trace to stdout. If rules files
- have been built with --compile=debug, line numbers will also be displayed.
-
- * `-z`:
- No final sentence pause at the end of the text.
-
- * `--stdout`:
- Write speech output to stdout.
-
- * `--compile=voicename`:
- Compile the pronunciation rules and dictionary in the current directory.
- =<voicename< is optional and specifies which language is compiled.
-
- * `--compile-debug=voicename`:
- Compile the pronunciation rules and dictionary in the current directory as
- above, but include line numbers, that get shown when -X is used.
-
- * `--ipa`:
- Write phonemes to stdout using International Phonetic Alphabet. --ipa=1 Use
- ties, --ipa=2 Use ZWJ, --ipa=3 Separate with _.
-
- * `--tie=<character>`:
- The character to use to join multi-letter phonemes in -x and --ipa output.
-
- * `--path=<path>`:
- Specifies the directory containing the espeak-ng-data directory.
-
- * `--pho`:
- Write mbrola phoneme data (.pho) to stdout or to the file in --phonout.
-
- * `--phonout=<filename>`:
- Write output from -x -X commands and mbrola phoneme data to this file.
-
- * `--punct="<characters>"`:
- Speak the names of punctuation characters during speaking. If
- =<characters> is omitted, all punctuation is spoken.
-
- * `--sep=<character>`:
- The character to separate phonemes from the -x and --ipa output.
-
- * `--voices[=<language code>]`:
- Lists the available voices. If =<language code> is present then only
- those voices which are suitable for that language are listed.
-
- * `--voices=<directory>`:
- Lists the voices in the specified subdirectory.
-
-## EXAMPLES
-
- * `espeak-ng "This is a test"`:
- Speak the sentence "This is a test" using the default English voice.
-
- * `espeak-ng -f hello.txt`:
- Speak the contents of hello.txt using the default English voice.
-
- * `cat hello.txt | espeak-ng`:
- Speak the contents of hello.txt using the default English voice.
-
- * `espeak-ng -x hello`:
- Speak the word "hello" using the default English voice, and print the
- phonemes that were spoken.
-
- * `espeak-ng -ven-us "[[h@'loU]]"`:
- Speak the phonemes "h@'loU" using the American English voice.
-
- * `espeak-ng --voices`:
- List all voices supported by eSpeak.
-
- * `espeak-ng --voices=en`:
- List all voices that speak English (`en`).
-
- * `espeak-ng --voices=mb`:
- List all voices using the MBROLA voice synthesizer.
-
-## AUTHOR
-
-eSpeak NG is maintained by Reece H. Dunn <msclrhd@gmail.com>. It is based on
-eSpeak by Jonathan Duddington <jonsd@jsd.clara.co.uk>.
-
-This manual page is based on the eSpeak page written by Luke Yelavich
-<themuso@ubuntu.com> for the Ubuntu project.
diff --git a/src/speak-ng.1.md b/src/speak-ng.1.md
new file mode 100644
index 00000000..b05b9ad4
--- /dev/null
+++ b/src/speak-ng.1.md
@@ -0,0 +1,159 @@
+# speak-ng(1) - A multi-lingual software speech synthesizer.
+{: data-date="July 2018"}
+
+## SYNOPSIS
+
+__speak-ng__ \[*options*\] \[*words*\]
+
+## DESCRIPTION
+
+__speak-ng__ is a software speech synthesizer for English, and some other
+languages.
+
+## OPTIONS
+
+`-h`, `--help`
+: Show summary of options.
+
+`--version`
+: Prints the espeak library version and the location of the espeak voice
+ data.
+
+`-f <text file>`
+: Text file to speak.
+
+`--stdin`
+: Read text input from stdin instead of a file.
+
+If neither `-f` nor `--stdin` are provided, `<words>` are spoken, or if no
+words are provided then text is spoken from stdin a line at a time.
+
+`-q`
+: Quiet, don't produce any speech (may be useful with `-x`).
+
+`-a <integer>`
+: Amplitude, 0 to 200, default is 100.
+
+`-g <integer>`
+: Word gap. Pause between words, units of 10ms at the default speed.
+
+`-k <integer>`
+: Indicate capital letters with: 1=sound, 2=the word \"capitals\", higher
+ values = a pitch increase (try `-k20`).
+
+`-l <integer>`
+: Line length. If not zero (which is the default), consider lines less than
+ this length as end-of-clause.
+
+`-p <integer>`
+: Pitch adjustment, 0 to 99, default is 50.
+
+`-s <integer>`
+: Speed in words per minute, default is 160.
+
+`-v <voice name>`
+: Use voice file of this name from espeak-ng-data/voices. A variant can be
+ specified using _voice_+_variant_, such as af+m3.
+
+`-w <wave file name>`
+: Write output to this WAV file, rather than speaking it directly.
+
+`--split=<minutes>`
+: Used with `-w` to split the audio output into \<minutes\> recorded
+ chunks.
+
+`-b`
+: Input text encoding, 1=UTF8, 2=8 bit, 4=16 bit.
+
+`-m`
+: Indicates that the text contains SSML (Speech Synthesis Markup Language)
+ tags or other XML tags. Those SSML tags which are supported are
+ interpreted. Other tags, including HTML, are ignored, except that some HTML
+ tags such as \<hr\> \<h2\> and \<li\> ensure a break in the speech.
+
+`-x`
+: Write phoneme mnemonics to stdout.
+
+`-X`
+: Write phonemes mnemonics and translation trace to stdout. If rules files
+ have been built with `--compile=debug`, line numbers will also be displayed.
+
+`-z`
+: No final sentence pause at the end of the text.
+
+`--stdout`
+: Write speech output to stdout.
+
+`--compile=voicename`
+: Compile the pronunciation rules and dictionary in the current directory.
+ =\<voicename\> is optional and specifies which language is compiled.
+
+`--compile-debug=voicename`
+: Compile the pronunciation rules and dictionary in the current directory as
+ above, but include line numbers, that get shown when `-X` is used.
+
+`--ipa`
+: Write phonemes to stdout using International Phonetic Alphabet. `--ipa=1`
+ Use ties, `--ipa=2` Use ZWJ, `--ipa=3` Separate with _.
+
+`--tie=<character>`
+: The character to use to join multi-letter phonemes in `-x` and `--ipa`
+ output.
+
+`--path=<path>`
+: Specifies the directory containing the espeak-ng-data directory.
+
+`--pho`
+: Write mbrola phoneme data (.pho) to stdout or to the file in `--phonout`.
+
+`--phonout=<filename>`
+: Write output from `-x` `-X` commands and mbrola phoneme data to this file.
+
+`--punct="<characters>"`
+: Speak the names of punctuation characters during speaking. If
+ =\<characters\> is omitted, all punctuation is spoken.
+
+`--sep=<character>`
+: The character to separate phonemes from the `-x` and `--ipa` output.
+
+`--voices[=<language code>]`
+: Lists the available voices. If =\<language code\> is present then only
+ those voices which are suitable for that language are listed.
+
+`--voices=<directory>`
+: Lists the voices in the specified subdirectory.
+
+## EXAMPLES
+
+`speak-ng "This is a test"`
+: Speak the sentence \"This is a test\" using the default English voice.
+
+`speak-ng -f hello.txt`
+: Speak the contents of hello.txt using the default English voice.
+
+`cat hello.txt | speak-ng`
+: Speak the contents of hello.txt using the default English voice.
+
+`speak-ng -x hello`
+: Speak the word \"hello\" using the default English voice, and print the
+ phonemes that were spoken.
+
+`speak-ng -ven-us "[[h@'loU]]"`
+: Speak the phonemes \"h@'loU\" using the American English voice.
+
+`speak-ng --voices`
+: List all voices supported by eSpeak.
+
+`speak-ng --voices=en`
+: List all voices that speak English (`en`).
+
+`speak-ng --voices=mb`
+: List all voices using the MBROLA voice synthesizer.
+
+## AUTHOR
+
+eSpeak NG is maintained by Reece H. Dunn <msclrhd@gmail.com>. It is based on
+eSpeak by Jonathan Duddington <jonsd@jsd.clara.co.uk>.
+
+This manual page is based on the eSpeak page written by Luke Yelavich
+<themuso@ubuntu.com> for the Ubuntu project.
diff --git a/src/speak-ng.1.ronn b/src/speak-ng.1.ronn
deleted file mode 100644
index 25c607f2..00000000
--- a/src/speak-ng.1.ronn
+++ /dev/null
@@ -1,158 +0,0 @@
-# speak-ng - A multi-lingual software speech synthesizer.
-
-## SYNOPSIS
-
-__speak-ng__ [<options>] [<<words>>]
-
-## DESCRIPTION
-
-__speak-ng__ is a software speech synthesizer for English, and some other
-languages.
-
-## OPTIONS
-
- * `-h`, `--help`:
- Show summary of options.
-
- * `--version`:
- Prints the espeak library version and the location of the espeak voice
- data.
-
- * `-f <text file>`:
- Text file to speak.
-
- * `--stdin`:
- Read text input from stdin instead of a file.
-
-If neither -f nor --stdin are provided, <words> are spoken, or if no
-words are provided then text is spoken from stdin a line at a time.
-
- * `-q`:
- Quiet, don't produce any speech (may be useful with -x).
-
- * `-a <integer>`:
- Amplitude, 0 to 200, default is 100.
-
- * `-g <integer>`:
- Word gap. Pause between words, units of 10ms at the default speed.
-
- * `-k <integer>`:
- Indicate capital letters with: 1=sound, 2=the word "capitals", higher
- values = a pitch increase (try -k20).
-
- * `-l <integer>`:
- Line length. If not zero (which is the default), consider lines less than
- this length as end-of-clause.
-
- * `-p <integer>`:
- Pitch adjustment, 0 to 99, default is 50.
-
- * `-s <integer>`:
- Speed in words per minute, default is 160.
-
- * `-v <voice name>`:
- Use voice file of this name from espeak-ng-data/voices. A variant can be
- specified using <voice>+<variant>, such as af+m3.
-
- * `-w <wave file name>`:
- Write output to this WAV file, rather than speaking it directly.
-
- * `--split=<minutes>`:
- Used with `-w` to split the audio output into <minutes> recorded
- chunks.
-
- * `-b`:
- Input text encoding, 1=UTF8, 2=8 bit, 4=16 bit.
-
- * `-m`:
- Indicates that the text contains SSML (Speech Synthesis Markup Language)
- tags or other XML tags. Those SSML tags which are supported are
- interpreted. Other tags, including HTML, are ignored, except that some HTML
- tags such as <hr> <h2> and <li> ensure a break in the
- speech.
-
- * `-x`:
- Write phoneme mnemonics to stdout.
-
- * `-X`:
- Write phonemes mnemonics and translation trace to stdout. If rules files
- have been built with --compile=debug, line numbers will also be displayed.
-
- * `-z`:
- No final sentence pause at the end of the text.
-
- * `--stdout`:
- Write speech output to stdout.
-
- * `--compile=voicename`:
- Compile the pronunciation rules and dictionary in the current directory.
- =<voicename< is optional and specifies which language is compiled.
-
- * `--compile-debug=voicename`:
- Compile the pronunciation rules and dictionary in the current directory as
- above, but include line numbers, that get shown when -X is used.
-
- * `--ipa`:
- Write phonemes to stdout using International Phonetic Alphabet. --ipa=1 Use
- ties, --ipa=2 Use ZWJ, --ipa=3 Separate with _.
-
- * `--tie=<character>`:
- The character to use to join multi-letter phonemes in -x and --ipa output.
-
- * `--path=<path>`:
- Specifies the directory containing the espeak-ng-data directory.
-
- * `--pho`:
- Write mbrola phoneme data (.pho) to stdout or to the file in --phonout.
-
- * `--phonout=<filename>`:
- Write output from -x -X commands and mbrola phoneme data to this file.
-
- * `--punct="<characters>"`:
- Speak the names of punctuation characters during speaking. If
- =<characters> is omitted, all punctuation is spoken.
-
- * `--sep=<character>`:
- The character to separate phonemes from the -x and --ipa output.
-
- * `--voices[=<language code>]`:
- Lists the available voices. If =<language code> is present then only
- those voices which are suitable for that language are listed.
-
- * `--voices=<directory>`:
- Lists the voices in the specified subdirectory.
-
-## EXAMPLES
-
- * `speak-ng "This is a test"`:
- Speak the sentence "This is a test" using the default English voice.
-
- * `speak-ng -f hello.txt`:
- Speak the contents of hello.txt using the default English voice.
-
- * `cat hello.txt | speak-ng`:
- Speak the contents of hello.txt using the default English voice.
-
- * `speak-ng -x hello`:
- Speak the word "hello" using the default English voice, and print the
- phonemes that were spoken.
-
- * `speak-ng -ven-us "[[h@'loU]]"`:
- Speak the phonemes "h@'loU" using the American English voice.
-
- * `speak-ng --voices`:
- List all voices supported by eSpeak.
-
- * `speak-ng --voices=en`:
- List all voices that speak English (`en`).
-
- * `speak-ng --voices=mb`:
- List all voices using the MBROLA voice synthesizer.
-
-## AUTHOR
-
-eSpeak NG is maintained by Reece H. Dunn <msclrhd@gmail.com>. It is based on
-eSpeak by Jonathan Duddington <jonsd@jsd.clara.co.uk>.
-
-This manual page is based on the eSpeak page written by Luke Yelavich
-<themuso@ubuntu.com> for the Ubuntu project.
--
2.14.4