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
- VERSION
Public Class Methods
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
truthy when this a release (d.d.d) version.
# File lib/ronn.rb 19 def self.release? 20 revision != '' && !revision.include?('-') 21 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. 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> <sha1> - 7c short SHA1 for HEAD
# File lib/ronn.rb 38 def self.revision 39 REV 40 end
A semantic version number based on the git revision. The third element of the version is incremented by the commit offset, such that version v0.6.6-5-gdacd74b => 0.6.11
# File lib/ronn.rb 26 def self.version 27 ver = revision.sub(/\Av/, '')[/^[0-9.-]+/].split(/[.-]/).map(&:to_i) 28 ver[2] += ver.pop while ver.size > 3 29 ver.join('.') 30 end