No commit activity in last 3 years
No release in over 3 years
Use TomDoc documentation format with YARD.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 0.4.0
>= 0
 Project Readme

YARD TomDoc

Website / Documentation / Issues / Source Code

Gem Version Build Status     Flattr Me

Description

Implements TomDoc syntax for YARD. 'Nuff said.

Instruction

Since yard-tomdoc is a standard YARD plugin, utilize it with yard's --plugin option.

$ yard --plugin tomdoc [...]

Limitations

Before you use yard-tomdoc you should read Loren Segal's blog post about the differences between YARD and TomDoc syntax. But note that the YARD TomDoc plugin now supports a superset of TomDoc's syntax which provides additional YARD functionality via cap-tags. For example using Author: James Deam in the documentation is equivalent to using @author James Dean in regular YARD syntax. Support is limited, but it opens up much more of YARD's goodness to TomDoc users then Loren's blog post suggests.

Acknowledgements

Huge thanks to Loren Segal, the creator of YARD and the original author of this plugin. Without his patient assistance and coding genius, this library would not have been possible.

Licensing

YARD TomDoc is copyrighted open-source software.

Copyright (c) 2010 Rubyworks. All rights reserved.

YARD TomDoc can be modified and redistributed in accordance with the terms of the MIT licsnse.

See the LICENSE.txt file for details.