Skip to content
This repository

A TomDoc Ruby library.

branch: tomdoc.rb

This branch is 0 commits ahead and 0 commits behind tomdoc.rb

Merge pull request #29 from parkr/patch-1

Can't forget visibility in method doc.
latest commit 970a92a409
7rans trans authored January 07, 2013
Octocat-spinner-32 bin use local lib path in bin February 13, 2011
Octocat-spinner-32 lib Refactoring on generators January 07, 2013
Octocat-spinner-32 man re-generate man page May 11, 2010
Octocat-spinner-32 test Refactoring on generators January 07, 2013
Octocat-spinner-32 try Can't forget visibility in method doc December 12, 2012
Octocat-spinner-32 .gitignore Add turn to Gemfile. [admin] March 02, 2012
Octocat-spinner-32 Gemfile Upgrade ruby_parser to 3.0 API November 18, 2012
Octocat-spinner-32 HISTORY.md Bump version to 0.2.5. [admin] March 02, 2012
Octocat-spinner-32 LICENSE TPW April 07, 2010
Octocat-spinner-32 README.md Typo June 01, 2012
Octocat-spinner-32 Rakefile Add turn to Gemfile. [admin] March 02, 2012
Octocat-spinner-32 tomdoc.gemspec adjust dependencies, ParseTree is not used May 23, 2011
Octocat-spinner-32 tomdoc.md special considerations May 11, 2010
README.md

TomDoc

TomDoc is documentation for humans. Using a few simple rules and zero special syntax you can produce great looking documentation for both humans and machines.

Just follow these four easy steps:

  1. Describe your method
  2. Optionally list and describe its arguments
  3. Optionally list some examples
  4. Explain what your method returns

Like this:

# Duplicate some text an arbitrary number of times.
#
# text  - The String to be duplicated.
# count - The Integer number of times to duplicate the text.
#
# Examples
#   multiplex('Tom', 4)
#   # => 'TomTomTomTom'
#
# Returns the duplicated String.
def multiplex(text, count)
  text * count
end

See the manual or the spec for a more in-depth analysis.

tomdoc.rb

This repository contains tomdoc.rb, a Ruby library for parsing TomDoc and generating pretty documentation from it.

Installation

easy_install Pygments
gem install tomdoc

tomdoc.rb has been tested with Ruby 1.8.7.

Usage

$ tomdoc file.rb
# Prints colored documentation of file.rb.

$ tomdoc file.rb -n STRING
# Prints methods or classes in file.rb matching STRING.

$ tomdoc fileA.rb fileB.rb ...
# Prints colored documentation of multiple files.

$ tomdoc -f html file.rb
# Prints HTML documentation of file.rb.

$ tomdoc -i file.rb
# Ignore TomDoc validation, print any methods we find.

$ tomdoc -h
# Displays more options.

Ruby API

Fully TomDoc'd. Well, it will be.

For now:

$ tomdoc lib/tomdoc/source_parser.rb

Formats

Console

tomdoc lib/tomdoc/source_parser.rb -n token

pattern

HTML

tomdoc -f html lib/tomdoc/source_parser.rb | browser

or

tomdoc -f html lib/tomdoc/source_parser.rb > doc.html
open doc.html

html

Local Dev

Want to hack on tomdoc.rb? Of course you do.

git clone http://github.com/defunkt/tomdoc.git
cd tomdoc
bundle install --local
ruby -rubygems ./bin/tomdoc lib/tomdoc/source_parser.rb
Something went wrong with that request. Please try again.