module Ronn

Ronn is a humane text format and toolchain for authoring manpages (and things that appear as manpages from a distance). Use it to build / install standard Unix roff(7) formatted manpages or to generate beautiful HTML manpages.

Constants

REV

value generated by: rake rev or edit manually; I'm not sure of how rake rev interacts with git tags -apjanke

VERSION

Public Class Methods

new(filename, attributes = {}, &block) click to toggle source

Create a new Ronn::Document for the given ronn file. See Ronn::Document.new for usage information.

   # File lib/ronn.rb
14 def self.new(filename, attributes = {}, &block)
15   Document.new(filename, attributes, &block)
16 end
release?() click to toggle source

truthy when this a release (d.d.d) version.

   # File lib/ronn.rb
19 def self.release?
20   revision != '' && !revision.include?('-')
21 end
revision() click to toggle source

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 commit is not tagged, this is a “<tag>-<offset>-<sha1>” string:

<tag>    - closest tag name
<offset> - number of commits ahead of <tag>
<sha1>   - 7c short SHA1 for HEAD
   # File lib/ronn.rb
38 def self.revision
39   REV
40 end
version() click to toggle source

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

   # File lib/ronn.rb
26 def self.version
27   ver = revision[/^[0-9.-]+/].split(/[.-]/).map(&:to_i)
28   ver[2] += ver.pop while ver.size > 3
29   ver.join('.')
30 end