114 lines
1.3 KiB
Markdown
114 lines
1.3 KiB
Markdown
---
|
|
title: Rdoc
|
|
category: Markup
|
|
layout: 2017/sheet
|
|
---
|
|
|
|
### Basic RDoc format
|
|
|
|
```rb
|
|
# Foo.
|
|
#
|
|
# @example
|
|
#
|
|
# y
|
|
# g
|
|
#
|
|
# @param [String] param_name The xx and xx.
|
|
#
|
|
# @see http://url.com
|
|
#
|
|
# @return [true] if so
|
|
```
|
|
|
|
### Inline
|
|
|
|
```markdown
|
|
*bold*
|
|
_emphasized_
|
|
+code+
|
|
```
|
|
|
|
```markdown
|
|
http://www.link.com
|
|
See Models::User@Examples
|
|
{Google}[http://google.com]
|
|
```
|
|
|
|
### Skip
|
|
|
|
```rb
|
|
def input # :nodoc:
|
|
```
|
|
|
|
```rb
|
|
module MyModule # :nodoc: all
|
|
```
|
|
|
|
### Definition lists
|
|
|
|
```rb
|
|
# == Definition lists
|
|
#
|
|
# list:: hi.
|
|
# +foo+:: parameterized
|
|
```
|
|
|
|
```rb
|
|
# == Definition lists
|
|
# [foo] also
|
|
# [bar] like this
|
|
```
|
|
|
|
### Return types
|
|
|
|
```rb
|
|
# @return [String]
|
|
# @return [String, nil] the name
|
|
```
|
|
|
|
### Callseq
|
|
|
|
```rb
|
|
# :call-seq:
|
|
# ARGF.readlines(sep=$/) -> array
|
|
# ARGF.readlines(limit) -> array
|
|
# ARGF.readlines(sep, limit) -> array
|
|
#
|
|
# ARGF.to_a(sep=$/) -> array
|
|
# ARGF.to_a(limit) -> array
|
|
# ARGF.to_a(sep, limit) -> array
|
|
```
|
|
|
|
### Category
|
|
|
|
```rb
|
|
# :category: Utilities
|
|
```
|
|
|
|
### Sections
|
|
|
|
```rb
|
|
# :section: Expiry methods
|
|
# methods relating to expiring
|
|
|
|
def expire!
|
|
def expired?
|
|
...
|
|
```
|
|
|
|
### Using tomdoc
|
|
|
|
```rb
|
|
# :markup: TomDoc
|
|
```
|
|
|
|
Place this at the beginning of the file.
|
|
|
|
## Also see
|
|
{: .-one-column}
|
|
|
|
* <http://rdoc.rubyforge.org/RDoc/Markup.html>
|
|
* <http://www.rubydoc.info/gems/yard/file/docs/GettingStarted.md>
|
|
{: .-also-see}
|