ronn-ng 0.10.0.pre.SNAPSHOT → 0.10.1.pre2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42d3c988ea961f9b89073f5534e6c0fc721c2f951e0a3d4e14f74987bab263db
-  data.tar.gz: ef7745fc686d7ba4de2bfa94f9071e05a675a18389a064cf651970976ba09e0f
+  metadata.gz: 19392851711576551758ca8fca8235a0a9784acd846e560e3808336aa8912d97
+  data.tar.gz: 8854f5df3e52079e811a4499262c5dd4a3127e309ec6efa2f2ddc35a041a6a1c
 SHA512:
-  metadata.gz: 3a065288a7f12e64f33c1c5fea974a1954e21b0ea56b96f934fbad5f1570ee5b71716d10feb9b28cf9cd894ef4a185054889fa1c698f249595b1e8abbc8f24f9
-  data.tar.gz: '0338fdc307af4380e99127bd9e137c53e6ea7c9ddb7e719616667602de4fd7cae856c7099a3b9053cdc02c4083b10feae666f87e40688016782433f8663d1cc8'
+  metadata.gz: c4e6ea4b5d05c5272714cc98cb34e83beb3b8a3a695c455d1d0c64ade25b43db134d45ea5b7294524bf7650d83127469ac2e45c401d6425f0242a5ed68761b39
+  data.tar.gz: 1a4846f9941112800514d6b418983278242fe7abb4f97b5ebd908cfe47a4be9fb231e782ef103fa73b12aaf6017528347522d8585067d4d4c89fb53378f4ac3a

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

@@ -1,14 +1,25 @@
 Ronn-NG CHANGES
 ===============
 
-Version 0.10.0 (2020 Oct 22)
+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.
+
 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

@@ -14,15 +14,15 @@ detail.
 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)
+* [ronn(1)](http://rtomayko.github.com/ronn/ronn.1) command -
+  [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)
+* [ronn-format(7)](http://rtomayko.github.com/ronn/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.
 
@@ -30,14 +30,14 @@ As an alternative, you might want to check out [pandoc](http://johnmacfarlane.ne
 
 Install with Homebrew on macOS:
 
-```
+```bash
 brew tap apjanke/ronn-ng
 brew install ronn-ng
 ```
 
 Install with `gem` anywhere that supports it:
 
-```
+```bash
 gem install ronn-ng
 ```
 
@@ -47,74 +47,90 @@ See [INSTALLING.md](INSTALLING.md) for details on other systems and installation
 
 Build roff and HTML output files for one or more input files:
 
-    $ ronn man/ronn.5.ronn
-    roff: man/ronn.5
-    html: man/ronn.5.html
+```bash
+$ ronn man/ronn.5.ronn
+roff: man/ronn.5
+html: man/ronn.5.html
+```
 
 Generate only a standalone HTML version of one or more files:
 
-    $ ronn --html man/markdown.5.ronn
-    html: man/markdown.5.html
+```bash
+$ ronn --html man/markdown.5.ronn
+html: man/markdown.5.html
+```
 
 Build roff versions of all ronn files in a directory:
 
-    $ ronn --roff man/*.ronn
+```bash
+$ ronn --roff man/*.ronn
+```
 
 View a ronn file as if it were a manpage without building intermediate files:
 
-    $ ronn --man man/markdown.5.ronn
+```bash
+$ ronn --man man/markdown.5.ronn
+```
 
 View roff output with man(1):
 
-    $ man man/ronn.5
+```bash
+$ man man/ronn.5
+```
 
 The [ronn(1)](http://rtomayko.github.com/ronn/ronn.1) manual page includes
 comprehensive documentation on `ronn` command line options.
 
 ## Background
 
-Some think Unix manual pages are a poor and outdated form of documentation. I
-disagree:
+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
+* Manpages follow a well defined structure that's immediately familiar. This
   gives developers a starting point when documenting new tools, libraries, and
   formats.
 
-- Manpages get to the point. Because they're written in an inverted style, with
+* Manpages get to the point. Because they're written in an inverted style, with
   a SYNOPSIS section followed by additional detail, prose and references to
   other sources of information, manpages provide the best of both cheat sheet
   and reference style documentation.
 
-- Historically, manpages use an extremely -- unbelievably -- limited set of
+* Historically, manpages use an extremely — unbelievably — limited set of
   text formatting capabilities. You get a couple of headings, lists, bold,
   underline and no more. This is a feature.
 
-- Although two levels of section hierarchy are technically supported, most
+* Although two levels of section hierarchy are technically supported, most
   manpages use only a single level. Unwieldy document hierarchies complicate
   otherwise good documentation. Remember that Feynman covered all of physics
-  -- heavenly bodies through QED -- with only two levels of document hierarchy
+  — heavenly bodies through QED — with only two levels of document hierarchy
   (_The Feynman Lectures on Physics_, 1970).
 
-- The classical terminal manpage display is typographically well thought out.
+* The classical terminal manpage display is typographically well thought out.
   Big bold section headings, justified monospace text, nicely indented
   paragraphs, intelligently aligned definition lists, and an informational
   header and footer.
 
-- Manpages have a simple referencing syntax; e.g., sh(1), fork(2), markdown(7).
+* Manpages have a simple referencing syntax; e.g., sh(1), fork(2), markdown(7).
   HTML versions can use this to generate links between pages.
 
 Unfortunately, figuring out how to create a manpage is a fairly tedious process.
 The roff/mandoc/mdoc macro languages are highly extensible, fractured between
-multiple dialects, and include a bunch of device specific stuff irrelevant to
-modern publishing tools.
+multiple dialects, and include a bunch of device-specific stuff irrelevant to
+modern publishing tools. Ronn aims to solve that problem.
 
 ## Requirements
 
-Ruby 2.3 or newer.
+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
 
-The project home page is at https://github.com/apjanke/ronn-ng. Bug reports,
+The project home page is at <https://github.com/apjanke/ronn-ng>. Bug reports,
 feature requests, and patch submissions are welcome.
 
 Ronn-NG was forked from the original Ronn project in 2018 after Ronn
@@ -127,10 +143,10 @@ MIT License.
 
 Ronn is Copyright (C) 2010 [Ryan Tomayko](http://tomayko.com/about).
 
-New Ronn-NG material is Copyright (C) 2018, 2019 [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)
@@ -250,10 +254,14 @@ module Ronn
         text = node.to_html.dup
         write escape(text)
 
+      elsif node.comment?
+        # ignore HTML comments
+
       elsif node.elem?
         case node.name
         when 'span'
           inline_filter(node.children)
+
         when 'code'
           if child_of?(node, 'pre')
             inline_filter(node.children)

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.0-SNAPSHOT'.freeze
+  REV = '0.10.1.pre2'.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,15 @@
 
   <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://www.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>
   </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 Andrew Janke, &copy; 2022 Takuya Noguchi</p>
 </div>
 </body>
 </html>

data/man/index.txt

@@ -4,12 +4,12 @@ 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

data/man/ronn-format.7

@@ -1,6 +1,6 @@
-.\" generated with Ronn-NG/v0.9.1
-.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "RONN\-FORMAT" "7" "December 2018" "Ronn-NG 0.9.1" "Ronn Manual"
+.\" generated with Ronn-NG/v0.10.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.10.1.pre2
+.TH "RONN\-FORMAT" "7" "December 2022" "Ronn-NG 0.10.1.pre2" "Ronn Manual"
 .SH "NAME"
 \fBronn\-format\fR \- manual authoring format based on Markdown
 .SH "SYNOPSIS"
@@ -83,7 +83,7 @@ HEADING TEXT
 .P
 Section headings should be all uppercase and may not contain inline markup\.
 .SH "INLINE MARKUP"
-Manpages have a limited set of text formatting capabilities\. There\'s basically \fBboldface\fR and \fIitalics\fR (often displayed using \fIunderline\fR)\. Ronn uses the following bits of markdown(7) to accomplish this:
+Manpages have a limited set of text formatting capabilities\. There's basically \fBboldface\fR and \fIitalics\fR (often displayed using \fIunderline\fR)\. Ronn uses the following bits of markdown(7) to accomplish this:
 .TP
 \fB\e`backticks\e`\fR (markdown compatible)
 Code, flags, commands, and noun\-like things; typically displayed in in \fBboldface\fR\. All text included within \fBbackticks\fR is displayed literally; other inline markup is not processed\. HTML output: \fB<code>\fR\.
@@ -97,7 +97,7 @@ User\-specified arguments, variables, or user input\. Typically displayed with \
 \fB_\fR\fIunderbars\fR\fB_\fR (markdown compatible)
 Emphasis\. May be used for literal option values\. Typically displayed with \fIunderline\fR in roff output\. HTML output: \fB<em>\fR\.
 .P
-Here is grep(1)\'s DESCRIPTION section represented in \fBronn\fR:
+Here is grep(1)'s DESCRIPTION section represented in \fBronn\fR:
 .IP "" 4
 .nf
 `Grep` searches the named input <FILE> (or standard input if
@@ -107,9 +107,9 @@ prints the matching lines\.
 .fi
 .IP "" 0
 .SH "DEFINITION LISTS"
-The definition list syntax is compatible with markdown\'s unordered list syntax but requires that the first line of each list item be terminated with a colon "\fB:\fR" character\. The contents of the first line is the \fIterm\fR; subsequent lines may be comprised of multiple paragraphs, code blocks, standard lists, and nested definition lists\.
+The definition list syntax is compatible with markdown's unordered list syntax but requires that the first line of each list item be terminated with a colon "\fB:\fR" character\. The contents of the first line is the \fIterm\fR; subsequent lines may be comprised of multiple paragraphs, code blocks, standard lists, and nested definition lists\.
 .P
-An example definition list, taken from BSD test(1)\'s \fIDESCRIPTION\fR section:
+An example definition list, taken from BSD test(1)'s \fIDESCRIPTION\fR section:
 .IP "" 4
 .nf
  The following primaries are used to construct expressions: