ronn-ng 0.10.1.pre1 → 0.10.1.pre3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 717e3056a1751d795f7584cdc1024e2b3f391ab1fad7a415f92384e2c09466fb
-  data.tar.gz: 6bfc3273ec1218c858248fe7783db4280f7bee0330b2deaf1673210ad1c0b1a0
+  metadata.gz: 4431d2e6f481e845cf8d537861b4727d1be790186d81e8a574bda9d8b98ac662
+  data.tar.gz: 5490717221cd544bc676c69b3776824a127d7251cd0a11f6df5f9916932e0206
 SHA512:
-  metadata.gz: afaf5a115cf75430f54f4699d2cc693172c358c5e2d8d4e86517bed361e5950066a0a923579b1e2aa660fdcedc317f565382e32adf109b51e3531e5e2af7d414
-  data.tar.gz: 20a63fce583758ce3ec9330a7550e451a735402997fe71f9d59fb90ce51bd2b7c8d7a94310d872173232d3012187a2423606f0daf689215e65fa61d1c99d6398
+  metadata.gz: d02713bcb099fcd2d0ba855f54930b9b7fc268f106d3394c746033c2568813185e86cc0338d047d8d7859263b18271d88f82ae26185eaf8f3d0e3848b34fc2a1
+  data.tar.gz: 2abd13e002ffa4390a35e444daedfa99d00a3d373389b243423606461be763fab8c1dfeaed30e7034f36b9b2262a4560b171a794d056af3bf747c32353ac372d

data/AUTHORS

@@ -1,8 +1,12 @@
-# This is a list of people who have contributed code or ideas to ronn -- for
-# copyright purposes or whatever.
+# Ronn-NG Authors
 
-Ryan Tomayko         <http://github.com/rtomayko>
-Chris Wanstrath      <http://github.com/defunkt>
-Suraj N. Kurapati    <http://github.com/sunaku>
-Hallison Batista     <http://github.com/hallison>
-Andrew Janke         <http://github.com/apjanke>
+This is a list of people who have contributed code or ideas to Ronn and Ronn-NG.
+
+Ryan Tomayko (original Ronn author)  <https://github.com/rtomayko>
+Andrew Janke (main Ronn-NG author)   <https://github.com/apjanke>
+
+Hallison Batista     <https://github.com/hallison>
+Suraj N. Kurapati    <https://github.com/sunaku>
+Takuya Noguchi       <https://github.com/tnir>
+Deivid Rodriguez     <https://github.com/deivid-rodriguez>
+Chris Wanstrath      <https://github.com/defunkt>

data/CHANGES

@@ -4,15 +4,21 @@ Ronn-NG CHANGES
 Version 0.10.1 (in progress)
 ----------------------------
 
+Note: The Ronn-NG 0.10.0 release does not exist, due to a RubyGems publishing mistake. 0.10.1 is
+the first 0.10.x release.
+
 * Switch to GitHub Flavored Markdown, fixing code block rendering (<https://github.com/apjanke/ronn-ng/pull/53>)
 * Revert `\[ci]` back to `\(bu)` (<https://github.com/apjanke/ronn-ng/pull/51>)
 * Minor fix to single-quote escaping (<https://github.com/apjanke/ronn-ng/issues/55>)
 * Elide HTML comments when producing roff output (<https://github.com/apjanke/ronn-ng/issues/65>)
+* Remove non-portable `more -i` option (<https://github.com/apjanke/ronn-ng/issues/71>)
+* Fix charset in HTML output's Content-Type (<https://github.com/apjanke/ronn-ng/pull/83>)
 * Bump to mustache 1.x
 
 Version 0.10.0 (never)
 ---------------------------
-* Doesn't exist due to a RubyGems publishing mistake
+
+Doesn't exist due to a RubyGems publishing mistake.
 
 Version 0.9.1 (2020 Apr 09)
 ---------------------------

data/INSTALLING.md

@@ -1,5 +1,4 @@
-Ronn-NG Installation
-====================
+# Ronn-NG Installation
 
 ## Installation Process
 
@@ -8,7 +7,7 @@ Ronn-NG Installation
 The best way to install Ronn-NG is with a package manager. This is currently
 only supported on macOS, with [Homebrew](http://brew.sh). To install with `brew`:
 
-```
+```bash
 brew tap apjanke/ronn-ng
 brew install ronn-ng
 ```
@@ -18,7 +17,7 @@ brew install ronn-ng
 Ronn-NG is distributed as a gem package, which can be used if you don't have
 a supported package manager. Install with rubygems:
 
-```
+```bash
 gem install ronn-ng
 ronn --help
 ```
@@ -32,7 +31,7 @@ completion directories pointing at the files in the installed gem.
 
 In Zsh, you can do something like this:
 
-```
+```bash
 ronn_dist_dir=$(dirname $(dirname $(gem which ronn-ng)))
 ronn_zsh_dir="$ronn_dist_dir/completion/zsh"
 ln -s "$ronn_zsh_dir/_ronn" /usr/local/share/zsh/site-functions
@@ -40,7 +39,7 @@ ln -s "$ronn_zsh_dir/_ronn" /usr/local/share/zsh/site-functions
 
 In Bash, something like this:
 
-```
+```bash
 ronn_dist_dir=$(dirname $(dirname $(gem which ronn-ng)))
 ronn_bash_dir="$ronn_dist_dir/completion/bash"
 ln -s "$ronn_bash_dir/ronn" /usr/local/etc/bash_completion.d
@@ -53,46 +52,49 @@ to be a limitation of the `gem` installation mechanism.
 If that `gem which` stuff doesn't work for you, you can `gem install gem-path`
 and use `gem path ronn-ng` instead.
 
-
 ## Building from Source
 
-Hacking? Install Ronn-NG from source.
+Hacking on Ronn? Install Ronn-NG from source.
 
-Clone the git repository and put ronn/bin on your PATH:
+Clone the git repository and put `ronn/bin` on your PATH:
 
-```
-git clone git://github.com/apjanke/ronn-ng
-PATH=$(pwd)/ronn-ng/bin:$PATH
+```bash
+git clone https://github.com/apjanke/ronn-ng
+PATH="$(pwd)/ronn-ng/bin:$PATH"
 ```
 
-The following gems are required for ronn-ng development:
- * nokogiri
- * mustache
- * kramdown
- * rubocop
- * sinatra
- * rack
- * rake
- * test-unit
+The following gems are required for Ronn-NG development:
 
-```
-gem install nokogiri mustache kramdown rubocop sinatra rack rake test-unit
-```
+* nokogiri
+* mustache
+* kramdown
+* rubocop
+* sinatra
+* rack
+* rake
+* test-unit
 
-Or install them with bundler using the project's gem definition:
+You can install them locally in your ronn-ng repo with bundler using the project's gem definition:
 
-```
+```bash
 bundle install --with development
 ```
 
+Or install them "globally" using gem:
+
+```bash
+gem install nokogiri mustache kramdown rubocop sinatra rack rake test-unit
+```
+
 Then you should be able to make changes directly to your cloned repo and have
 them be reflected in your active `ronn` command.
 
 ## Legacy Versions
 
 Historical Ronn tarballs available at [the original Ronn repo](http://github.com/rtomayko/ronn/downloads).
+This is the originall Ronn project that Ronn-NG was forked from.
 
-```
+```brew
 curl -L http://github.com/rtomayko/ronn/downloads/0.6.6 | tar xvzf -
 cd rtomayko-r*
 ruby setup.rb

data/LICENSE.txt

@@ -1,7 +1,7 @@
 The MIT License
 
        Copyright (C) 2009 Ryan Tomayko <tomayko.com/about>
-       Copyright (C) 2018, 2019 Andrew Janke <apjanke.net>
+       Copyright (C) 2018, 2019, 2020, 2022 Andrew Janke <apjanke.net>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

data/README.md

@@ -15,14 +15,14 @@ The `*.ronn` files found in the [`man/`][1] directory show off a wide range of
 ronn capabilities:
 
 * [ronn(1)](http://rtomayko.github.com/ronn/ronn.1) command -
-  [source file](http://github.com/apjanke/ronn-ng/blob/master/man/ronn.1.ronn),
-  [roff output](http://github.com/apjanke/ronn-ng/blob/master/man/ronn.1)
+  [source file](http://github.com/apjanke/ronn-ng/blob/main/man/ronn.1.ronn),
+  [roff output](http://github.com/apjanke/ronn-ng/blob/main/man/ronn.1)
 
 * [ronn-format(7)](http://rtomayko.github.com/ronn/ronn-format.7) -
-  [source file](http://github.com/apjanke/ronn-ng/blob/master/man/ronn-format.7.ronn),
-  [roff output](http://github.com/apjanke/ronn-ng/blob/master/man/ronn-format.7)
+  [source file](http://github.com/apjanke/ronn-ng/blob/main/man/ronn-format.7.ronn),
+  [roff output](http://github.com/apjanke/ronn-ng/blob/main/man/ronn-format.7)
 
-[1]: http://github.com/apjanke/ronn-ng/tree/master/man
+[1]: http://github.com/apjanke/ronn-ng/tree/main/man
 
 As an alternative, you might want to check out [pandoc](http://johnmacfarlane.net/pandoc/) which can also convert markdown into roff manual pages.
 
@@ -83,7 +83,7 @@ comprehensive documentation on `ronn` command line options.
 
 ## Background
 
-Some think Unix manual pages are a poor and outdated form of documentation. Ronn-NG
+Some think Unix man pages are a poor and outdated form of documentation. Ronn-NG
 disagrees:
 
 * Manpages follow a well defined structure that's immediately familiar. This
@@ -120,7 +120,13 @@ modern publishing tools. Ronn aims to solve that problem.
 
 ## Requirements
 
-Ruby 2.3 or newer, and gems as listed in `ronn-ng.gemspec`.
+Ronn-NG requires Ruby 2.4 or newer.
+
+Ruby 3.x support is a work in progress as of Ronn-NG 0.10.1 (December 2022).
+
+If you are installing Ronn-NG as a standalone program (the usual way to use it), it
+includes all its Ruby libraries, and has no other dependencies. If you are using
+Ronn-NG as a gem or other library, it requires gems as listed in `ronn-ng.gemspec`.
 
 ## Project Management
 
@@ -137,10 +143,10 @@ MIT License.
 
 Ronn is Copyright (C) 2010 [Ryan Tomayko](http://tomayko.com/about).
 
-New Ronn-NG material is Copyright (C) 2018-2020 [Andrew Janke](https://apjanke.net).
+New Ronn-NG material is Copyright (C) 2018-2022 [Andrew Janke](https://apjanke.net) and other contributors.
 
 See the file LICENSE.txt for information of licensing and distribution.
 
 ## Build Status
 
-![Travis build status](https://travis-ci.com/apjanke/ronn-ng.svg?branch=master)
+![Travis build status](https://travis-ci.com/apjanke/ronn-ng.svg?branch=main)

data/Rakefile

@@ -69,7 +69,7 @@ end
 task :rev do
   rev = ENV['REV'] || `git describe --tags`.chomp
   data = File.read('lib/ronn.rb')
-  data.gsub!(/^( *)REV *=.*/, "\\1REV = '#{rev}'")
+  data.gsub!(/^( *)REV *=.*/, "\\1REV = '#{rev.sub(/\Av/, '')}'.freeze")
   File.open('lib/ronn.rb', 'wb') { |fd| fd.write(data) }
   puts "revision: #{rev}"
   puts "version:  #{`ruby -Ilib -rronn -e 'puts Ronn::VERSION'`}"

data/bin/ronn

@@ -87,7 +87,7 @@ options = {}
 write_index = false
 styles = %w[man]
 groff = 'groff -Wall -mtty-char -mandoc -Tascii -t'
-pager = ENV['MANPAGER'] || ENV['PAGER'] || 'more -is'
+pager = ENV['MANPAGER'] || ENV['PAGER'] || 'more -s'
 output_dir = nil
 
 ##

data/lib/ronn/document.rb

@@ -179,11 +179,14 @@ module Ronn
     end
 
     # The date the man page was published. If not set explicitly,
-    # this is the file's modified time or, if no file is given,
+    # it first checks for "SOURCE_DATE_EPOCH" to support reproducible
+    # builds, then the file's modified time or, if no file is given,
     # the current time. Center displayed in the document footer.
     def date
       return @date if @date
 
+      return Time.at(ENV['SOURCE_DATE_EPOCH'].to_i).gmtime if ENV['SOURCE_DATE_EPOCH']
+
       return File.mtime(path) if File.exist?(path)
 
       Time.now

data/lib/ronn/roff.rb

@@ -111,6 +111,10 @@ module Ronn
           macro 'SH', quote(escape(node.inner_html))
         when 'h3'
           macro 'SS', quote(escape(node.inner_html))
+        when 'h4', 'h5', 'h6'
+          # Ronn discourages use of this many heading levels, but if they are used,
+          # we should make them legible instead of ignoring them.
+          macro 'SS', quote(escape(node.inner_html))
 
         when 'p'
           prev = previous(node)

data/lib/ronn/template/default.html

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <meta http-equiv='content-type' content='text/html;charset=utf8'>
+  <meta http-equiv='content-type' content='text/html;charset=utf-8'>
   <meta name='generator' content='{{ generator }}'>
   <title>{{ title }}</title>
   {{{ stylesheet_tags }}}

data/lib/ronn.rb

@@ -22,15 +22,15 @@ module Ronn
 
   # A semantic version number based on the git revision. The third element
   # of the version is incremented by the commit offset, such that version
-  # 0.6.6-5-gdacd74b => 0.6.11
+  # v0.6.6-5-gdacd74b => 0.6.11
   def self.version
-    ver = revision[/^[0-9.-]+/].split(/[.-]/).map(&:to_i)
+    ver = revision.sub(/\Av/, '')[/^[0-9.-]+/].split(/[.-]/).map(&:to_i)
     ver[2] += ver.pop while ver.size > 3
     ver.join('.')
   end
 
   # The string revision as reported by: git-describe --tags. This is just the
-  # tag name when a tag references the HEAD commit (e.g. 0.6.25). When the HEAD
+  # tag name when a tag references the HEAD commit (e.g. v0.6.25). When the HEAD
   # commit is not tagged, this is a "<tag>-<offset>-<sha1>" string:
   #   <tag>    - closest tag name
   #   <offset> - number of commits ahead of <tag>
@@ -40,8 +40,6 @@ module Ronn
   end
 
   # value generated by: rake rev
-  # or edit manually; I'm not sure of how rake rev interacts with git
-  # tags -apjanke
-  REV = '0.10.1.pre1'.freeze
+  REV = '0.10.1.pre3'.freeze
   VERSION = version
 end

data/man/index.html

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title>Ronn</title>
+  <title>Ronn-NG</title>
   <style>
     body {
       font-size:24px;
@@ -41,16 +41,16 @@
 </head>
 <body>
 <div id='index'>
-  <h1>Ronn</h1>
+  <h1>Ronn-NG</h1>
   <h3>Builds manuals</h3>
 
   <h4>Auxiliary</h4>
   <p class='aux'>
-    <a href='http://github.com/apjanke/ronn-ng#readme'>README</a>,
-    <a href='http://github.com/apjanke/ronn-ng/blob/master/INSTALLING#files'>INSTALLING</a>,
-    <a href='http://github.com/apjanke/ronn-ng/blob/master/CHANGES#files'>CHANGES</a>,
-    <a href='http://github.com/apjanke/ronn-ng/blob/master/COPYING#files'>COPYING</a>,
-    <a href='http://github.com/apjanke/ronn-ng/blob/master/AUTHORS#files'>AUTHORS</a>
+    <a href='https://github.com/apjanke/ronn-ng#readme'>README</a>,
+    <a href='https://github.com/apjanke/ronn-ng/blob/main/INSTALLING.md'>INSTALLING</a>,
+    <a href='https://github.com/apjanke/ronn-ng/blob/main/CHANGES'>CHANGES</a>,
+    <a href='https://github.com/apjanke/ronn-ng/blob/main/LICENSE.txt'>LICENSE</a>,
+    <a href='https://github.com/apjanke/ronn-ng/blob/main/AUTHORS'>AUTHORS</a>
   </p>
 
   <h4>Manuals</h4>
@@ -64,15 +64,16 @@
 
   <h4>See Also</h4>
   <p class='also'>
-    <a class='man-ref' href="http://developer.apple.com/mac/library/documentation/Darwin/Reference/ManPages/man5/manpages.5.html">manpages(5)</a>,
-    <a class='man-ref' href="http://daringfireball.net/projects/markdown/syntax">markdown(7)</a>,
-    <a class='man-ref' href="http://man.cx/man(1)">man(1)</a>,
-    <a class='man-ref' href="http://man.cx/roff(7)">roff(7)</a>,
-    <a class='man-ref' href="http://man.cx/groff(1)">groff(1)</a>,
-    <a class='man-ref' href="http://mustache.github.com/mustache.5.html">mustache(5)</a>
+    <a class='man-ref' href="https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man5/manpages.5.html">manpages(5)</a>,
+    <a class='man-ref' href="https://daringfireball.net/projects/markdown/syntax">markdown(7)</a>,
+    <a class='man-ref' href="https://man7.org/linux/man-pages/man1/man.1.html">man(1)</a>,
+    <a class='man-ref' href="https://man7.org/linux/man-pages/man7/roff.7.html">roff(7)</a>,
+    <a class='man-ref' href="https://man7.org/linux/man-pages/man1/groff.1.html">groff(1)</a>,
+    <a class='man-ref' href="https://mustache.github.io/mustache.5.html">mustache(5)</a>,
+    <a class='man-ref' href="https://linux.die.net/man/1/pandoc">pandoc(1)</a>
   </p>
 
-  <p class='copy'>Copyright &copy; 2010 Ryan Tomayko, &copy; 2018 Andrew Janke</p>
+  <p class='copy'>Copyright &copy; 2010 Ryan Tomayko, &copy; 2018, 2019, 2020, 2022, 2023 Andrew Janke, &copy; 2022 Takuya Noguchi</p>
 </div>
 </body>
 </html>

data/man/index.txt

@@ -4,12 +4,13 @@ ronn(5)     ronn.5.ronn
 ronn(7)     ronn.7.ronn
 
 # external manuals
-roff(7)     http://man.cx/roff(7)
-grep(1)     http://man.cx/grep(1)
-groff(1)    http://man.cx/groff(1)
-sh(1)       http://man.cx/sh(1posix)
-test(1)     http://man.cx/test(1)
-fork(2)     http://man.cx/fork(2)
-man(1)      http://man.cx/man(1)
-markdown(7) http://daringfireball.net/projects/markdown/syntax
-manpages(5) http://developer.apple.com/mac/library/documentation/Darwin/Reference/ManPages/man5/manpages.5.html
+roff(7)     https://man7.org/linux/man-pages/man7/roff.7.html
+grep(1)     https://man7.org/linux/man-pages/man1/grep.1.html
+groff(1)    https://man7.org/linux/man-pages/man1/groff.1.html
+sh(1)       https://man7.org/linux/man-pages/man1/sh.1p.html
+test(1)     https://man7.org/linux/man-pages/man1/test.1.html
+fork(2)     https://man7.org/linux/man-pages/man2/fork.2.html
+man(1)      https://man7.org/linux/man-pages/man1/man.1.html
+markdown(7) https://daringfireball.net/projects/markdown/syntax
+manpages(5) https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man5/manpages.5.html
+pandoc(1)   https://linux.die.net/man/1/pandoc

data/man/ronn-format.7

@@ -1,6 +1,6 @@
 .\" generated with Ronn-NG/v0.10.1
-.\" http://github.com/apjanke/ronn-ng/tree/0.10.1.pre1
-.TH "RONN\-FORMAT" "7" "December 2018" "Ronn-NG 0.10.1.pre1" "Ronn Manual"
+.\" http://github.com/apjanke/ronn-ng/tree/0.10.1.pre3
+.TH "RONN\-FORMAT" "7" "December 2022" "Ronn-NG 0.10.1.pre3" "Ronn Manual"
 .SH "NAME"
 \fBronn\-format\fR \- manual authoring format based on Markdown
 .SH "SYNOPSIS"

data/man/ronn.1

@@ -1,6 +1,6 @@
 .\" generated with Ronn-NG/v0.10.1
-.\" http://github.com/apjanke/ronn-ng/tree/0.10.1.pre1
-.TH "RONN" "1" "January 2020" "Ronn-NG 0.10.1.pre1" "Ronn Manual"
+.\" http://github.com/apjanke/ronn-ng/tree/0.10.1.pre3
+.TH "RONN" "1" "January 2023" "Ronn-NG 0.10.1.pre3" "Ronn Manual"
 .SH "NAME"
 \fBronn\fR \- convert markdown files to manpages
 .SH "SYNOPSIS"
@@ -31,23 +31,28 @@ Source files must be in UTF\-8 encoding, or the encoding specified by the \fB\-E
 When building roff or HTML output files, destination filenames are determined by taking the basename of the input \fIfile\fR and adding the appropriate file extension (or removing the file extension in the case of roff output)\. For example, executing \fBronn example\.1\.ronn\fR generates \fBexample\.1\fR with roff output and \fBexample\.1\.html\fR with HTML output\.
 .SH "OPTIONS"
 These options control whether output is written to file(s), standard output, or directly to a man pager\.
-.IP "\(bu" 4
-\fB\-m\fR, \fB\-\-man\fR: Don't generate files, display \fIfile\fRs as if man(1) were invoked on the roff output file\. This simulates default man behavior by piping the roff output through groff(1) and the paging program specified by the \fBMANPAGER\fR environment variable\.
-.IP "\(bu" 4
-\fB\-S\fR, \fB\-\-server\fR: Don't generate files, start an HTTP server at \fIhttp://localhost:1207/\fR and serve dynamically generated HTML for the set of input \fIfile\fRs\. A file named \fIexample\.2\.ronn\fR is served as \fI/example\.2\.html\fR\. There's also an index page at the root with links to each \fIfile\fR\.
+.TP
+\fB\-m\fR, \fB\-\-man\fR
+Don't generate files, display \fIfile\fRs as if man(1) were invoked on the roff output file\. This simulates default man behavior by piping the roff output through groff(1) and the paging program specified by the \fBMANPAGER\fR environment variable\.
+.TP
+\fB\-S\fR, \fB\-\-server\fR
+Don't generate files, start an HTTP server at \fIhttp://localhost:1207/\fR and serve dynamically generated HTML for the set of input \fIfile\fRs\. A file named \fIexample\.2\.ronn\fR is served as \fI/example\.2\.html\fR\. There's also an index page at the root with links to each \fIfile\fR\.
 .IP
 The server respects the \fB\-\-style\fR and document attribute options (\fB\-\-manual\fR, \fB\-\-date\fR, etc\.)\. These same options can be varied at request time by giving them as query parameters: \fB?manual=FOO&style=dark,toc\fR
 .IP
 \fINOTE: The builtin server is designed to assist in the process of writing and styling manuals\. It is in no way recommended as a general purpose web server\.\fR
-.IP "\(bu" 4
-\fB\-\-port\fR=\fIport\fR When used with \fB\-S\fR/\fB\-\-server\fR, runs the server at the specified port instead of the default port 1207\.
-.IP "\(bu" 4
-\fB\-\-pipe\fR: Don't generate files, write generated output to standard output\. This is the default behavior when ronn source text is piped in on standard input and no \fIfile\fR arguments are provided\.
-.IP "\(bu" 4
-\fB\-o\fR=\fIdirectory\fR, \fB\-\-output\-dir\fR=\fIdirectory\fR: Write generated files to the specified directory instead of the default location\.
-.IP "\(bu" 4
-\fB\-E\fR=\fIencoding\fR, \fB\-\-encoding\fR=<encoding: Specify the encoding that input files are in\. Default is UTF\-8, regardless of user's locale settings\. Input sent to STDIN is always treated as UTF\-8, regardless of whether \fB\-E\fR is passed\.
-.IP "" 0
+.TP
+\fB\-\-port\fR=\fIport\fR
+When used with \fB\-S\fR/\fB\-\-server\fR, runs the server at the specified port instead of the default port 1207\.
+.TP
+\fB\-\-pipe\fR
+Don't generate files, write generated output to standard output\. This is the default behavior when ronn source text is piped in on standard input and no \fIfile\fR arguments are provided\.
+.TP
+\fB\-o\fR=\fIdirectory\fR, \fB\-\-output\-dir\fR=\fIdirectory\fR
+Write generated files to the specified directory instead of the default location\.
+.TP
+\fB\-E\fR=\fIencoding\fR, \fB\-\-encoding\fR=\fIencoding\fR
+Specify the encoding that input files are in\. Default is UTF\-8, regardless of user's locale settings\. Input sent to STDIN is always treated as UTF\-8, regardless of whether \fB\-E\fR is passed\.
 .P
 Format options control the files \fBronn\fR generates, or the output format when the \fB\-\-pipe\fR argument is specified\. When no format options are given, both \fB\-\-roff\fR and \fB\-\-html\fR are assumed\.
 .TP
@@ -101,11 +106,11 @@ whisky(1)    whisky\.1\.ronn
 tango(5)     tango\.5\.ronn
 
 # external manuals
-grep(1)      http://man\.cx/grep(1)
-ls(1)        http://man\.cx/ls(1)
+grep(1)      https://man7\.org/linux/man\-pages/man1/grep\.1\.html
+ls(1)        https://man7\.org/linux/man\-pages/man1/ls\.1\.html
 
 # other URLs for use with markdown reference links
-src          http://github\.com/
+src          https://github\.com/
 .fi
 .IP "" 0
 .P
@@ -149,7 +154,7 @@ The heading and footing, respectively\.
 \fB\.man\-title\fR
 The main \fB<h1>\fR element\. Hidden by default unless the manual has no \fIname\fR or \fIsection\fR attributes\.
 .P
-See the builtin style sources \fIhttp://github\.com/apjanke/ronn\-ng/tree/master/lib/ronn/template\fR for examples\.
+See the builtin style sources \fIhttps://github\.com/apjanke/ronn\-ng/tree/main/lib/ronn/template\fR for examples\.
 .SH "EXAMPLES"
 Build roff and HTML output files and view the roff manpage using man(1):
 .IP "" 4
@@ -222,6 +227,6 @@ The paging program used for man pages\. This is typically set to something like
 \fBPAGER\fR
 Used instead of \fBMANPAGER\fR when \fBMANPAGER\fR is not defined\.
 .SH "COPYRIGHT"
-Ronn\-NG is Copyright (C) 2009 Ryan Tomayko \fIhttp://tomayko\.com/about\fR and (C) 2018 Andrew Janke \fIhttps://apjanke\.net\fR
+Ronn\-NG is Copyright (C) 2009 Ryan Tomayko \fIhttps://tomayko\.com/about\fR, (C) 2018\-2023 Andrew Janke \fIhttps://apjanke\.net\fR, and other contributors\. See the AUTHORS file in the Ronn\-NG distribution for full details\.
 .SH "SEE ALSO"
 groff(1), man(1), pandoc(1), manpages(5), markdown(7), roff(7), ronn\-format(7)

data/man/ronn.1.ronn

@@ -70,7 +70,7 @@ directly to a man pager.
     and styling manuals. It is in no way recommended as a general purpose web
     server.*
 
-  * `--port`=<port>
+  * `--port`=<port>:
     When used with `-S`/`--server`, runs the server at the specified port instead
     of the default port 1207.
 
@@ -83,7 +83,7 @@ directly to a man pager.
     Write generated files to the specified directory instead of the default
     location.
   
-  * `-E`=<encoding>, `--encoding`=<encoding:
+  * `-E`=<encoding>, `--encoding`=<encoding>:
     Specify the encoding that input files are in. Default is UTF-8, regardless
     of user's locale settings. Input sent to STDIN is always treated as UTF-8,
     regardless of whether `-E` is passed.
@@ -164,11 +164,11 @@ ignored:
     tango(5)     tango.5.ronn
 
     # external manuals
-    grep(1)      http://man.cx/grep(1)
-    ls(1)        http://man.cx/ls(1)
+    grep(1)      https://man7.org/linux/man-pages/man1/grep.1.html
+    ls(1)        https://man7.org/linux/man-pages/man1/ls.1.html
 
     # other URLs for use with markdown reference links
-    src          http://github.com/
+    src          https://github.com/
 
 The <location> is an absolute or relative URL that usually points at an HTML
 version of manpage. It's possible to define references for things that aren't
@@ -237,7 +237,7 @@ allow targeting all generated elements:
 
 See the [builtin style sources][builtin] for examples.
 
-[builtin]: http://github.com/apjanke/ronn-ng/tree/master/lib/ronn/template
+[builtin]: https://github.com/apjanke/ronn-ng/tree/main/lib/ronn/template
           "Builtin Stylesheet .css files"
 
 ## EXAMPLES
@@ -309,8 +309,9 @@ under a `man/` directory:
 
 ## COPYRIGHT
 
-Ronn-NG is Copyright (C) 2009 Ryan Tomayko <http://tomayko.com/about> and
-(C) 2018 Andrew Janke <https://apjanke.net>
+Ronn-NG is Copyright (C) 2009 Ryan Tomayko <https://tomayko.com/about>,
+(C) 2018-2023 Andrew Janke <https://apjanke.net>, and other contributors.
+See the AUTHORS file in the Ronn-NG distribution for full details.
 
 ## SEE ALSO