RubyGems - tdiary - Versions diffs - 3.2.2.20130507 - Mend

tdiary 3.2.2.20130507

Files changed (509) hide show

checksums.yaml +7 -0
data/.coveralls.yml +1 -0
data/.gitignore +16 -0
data/.travis.yml +29 -0
data/Capfile +2 -0
data/ChangeLog +3173 -0
data/Gemfile +58 -0
data/Gemfile.lock +201 -0
data/LICENSE +340 -0
data/Procfile +1 -0
data/README.md +33 -0
data/Rakefile +26 -0
data/bin/tdiary +7 -0
data/config.ru +61 -0
data/data/.htaccess +2 -0
data/doc/HOWTO-authenticate-in-rack.md +89 -0
data/doc/HOWTO-make-io.md +305 -0
data/doc/HOWTO-make-plugin.md +279 -0
data/doc/HOWTO-make-theme.md +67 -0
data/doc/HOWTO-testing-tDiary.md +44 -0
data/doc/HOWTO-use-plugin.md +148 -0
data/doc/HOWTO-write-tDiary.en.md +131 -0
data/doc/HOWTO-write-tDiary.md +136 -0
data/doc/INSTALL-paas.md +202 -0
data/doc/INSTALL.md +160 -0
data/doc/README.en.md +174 -0
data/doc/README.md +56 -0
data/doc/UPGRADE.md +164 -0
data/doc/doc.css +115 -0
data/dot.htaccess +27 -0
data/index.fcgi +45 -0
data/index.rb +57 -0
data/js/00default.js +60 -0
data/js/01conf.js +62 -0
data/js/02edit.coffee +5 -0
data/js/02edit.js +15 -0
data/js/amazon.js +43 -0
data/js/calendar3.js +130 -0
data/js/caretposition.js +170 -0
data/js/category.js +29 -0
data/js/category_autocomplete.js +96 -0
data/js/comment_ajax.js +27 -0
data/js/draft.js +149 -0
data/js/highlight.js +36 -0
data/js/image.js +181 -0
data/misc/convert2.rb +123 -0
data/misc/filter/antispamservice.rb +101 -0
data/misc/filter/limitdays.rb +40 -0
data/misc/filter/linkcheck.rb +81 -0
data/misc/filter/plugin/antispamservice.rb +82 -0
data/misc/filter/plugin/en/antispamservice.rb +21 -0
data/misc/filter/plugin/ja/antispamservice.rb +20 -0
data/misc/lib/README +4 -0
data/misc/lib/compatible.rb +1 -0
data/misc/lib/fcgi_patch.rb +90 -0
data/misc/migrate.rb +157 -0
data/misc/paas/cloudfoundry/Gemfile +26 -0
data/misc/paas/cloudfoundry/Gemfile.lock +85 -0
data/misc/paas/heroku/Gemfile +22 -0
data/misc/paas/heroku/Gemfile.lock +85 -0
data/misc/paas/sqale/Gemfile +19 -0
data/misc/paas/sqale/Gemfile.lock +85 -0
data/misc/paas/sqale/Procfile +1 -0
data/misc/paas/sqale/dot.env +1 -0
data/misc/plugin/ChangeLog.DO_NOT_UPDATE +2333 -0
data/misc/plugin/a.rb +211 -0
data/misc/plugin/amazon.rb +403 -0
data/misc/plugin/amazon/README.en +17 -0
data/misc/plugin/amazon/README.ja +29 -0
data/misc/plugin/amazon/amazonimg.rb +113 -0
data/misc/plugin/amazon/large.png +0 -0
data/misc/plugin/amazon/medium.png +0 -0
data/misc/plugin/amazon/small.png +0 -0
data/misc/plugin/append-css.rb +51 -0
data/misc/plugin/bq.rb +48 -0
data/misc/plugin/calendar2.rb +184 -0
data/misc/plugin/calendar3.rb +256 -0
data/misc/plugin/category.rb +779 -0
data/misc/plugin/category_autocomplete.rb +33 -0
data/misc/plugin/comment_ajax.rb +11 -0
data/misc/plugin/comment_mail-qmail.rb +57 -0
data/misc/plugin/comment_mail-sendmail.rb +56 -0
data/misc/plugin/comment_mail-smtp.rb +59 -0
data/misc/plugin/comment_rank.rb +36 -0
data/misc/plugin/counter.rb +631 -0
data/misc/plugin/daily_theme.rb +55 -0
data/misc/plugin/disp_referrer.rb +1486 -0
data/misc/plugin/doctype-html401tr.rb +16 -0
data/misc/plugin/draft.rb +20 -0
data/misc/plugin/dropdown_calendar.rb +32 -0
data/misc/plugin/edit_today.rb +50 -0
data/misc/plugin/en/a.rb +10 -0
data/misc/plugin/en/amazon.rb +71 -0
data/misc/plugin/en/append-css.rb +17 -0
data/misc/plugin/en/bq.rb +12 -0
data/misc/plugin/en/calendar2.rb +12 -0
data/misc/plugin/en/category.rb +204 -0
data/misc/plugin/en/counter.rb +48 -0
data/misc/plugin/en/daily_theme.rb +14 -0
data/misc/plugin/en/disp_referrer.rb +387 -0
data/misc/plugin/en/dropdown_calendar.rb +14 -0
data/misc/plugin/en/edit_today.rb +22 -0
data/misc/plugin/en/hide-mail-field.rb +19 -0
data/misc/plugin/en/highlight.rb +29 -0
data/misc/plugin/en/image.rb +54 -0
data/misc/plugin/en/kw.rb +22 -0
data/misc/plugin/en/makerss.rb +47 -0
data/misc/plugin/en/pb-show.rb +21 -0
data/misc/plugin/en/ping.rb +16 -0
data/misc/plugin/en/recent_comment.rb +44 -0
data/misc/plugin/en/recent_comment3.rb +56 -0
data/misc/plugin/en/recent_rss.rb +33 -0
data/misc/plugin/en/referer_scheme.rb +48 -0
data/misc/plugin/en/search_control.rb +74 -0
data/misc/plugin/en/search_form.rb +22 -0
data/misc/plugin/en/speed_comment.rb +19 -0
data/misc/plugin/en/tb-show.rb +37 -0
data/misc/plugin/en/todo.rb +43 -0
data/misc/plugin/en/weather.rb +185 -0
data/misc/plugin/en/xmlrpc.rb +14 -0
data/misc/plugin/footnote.rb +92 -0
data/misc/plugin/gradation.rb +39 -0
data/misc/plugin/gradient.rb +36 -0
data/misc/plugin/hide-mail-field.rb +50 -0
data/misc/plugin/highlight.rb +22 -0
data/misc/plugin/html_anchor.rb +34 -0
data/misc/plugin/image.rb +290 -0
data/misc/plugin/ja/amazon.rb +89 -0
data/misc/plugin/ja/bq.rb +13 -0
data/misc/plugin/ja/calendar2.rb +12 -0
data/misc/plugin/ja/category.rb +212 -0
data/misc/plugin/ja/daily_theme.rb +15 -0
data/misc/plugin/ja/disp_referrer.rb +644 -0
data/misc/plugin/ja/edit_today.rb +23 -0
data/misc/plugin/ja/hide-mail-field.rb +20 -0
data/misc/plugin/ja/highlight.rb +30 -0
data/misc/plugin/ja/makerss.rb +44 -0
data/misc/plugin/ja/my-sequel.rb +52 -0
data/misc/plugin/ja/pb-show.rb +23 -0
data/misc/plugin/ja/ping.rb +17 -0
data/misc/plugin/ja/recent_comment.rb +45 -0
data/misc/plugin/ja/recent_comment3.rb +57 -0
data/misc/plugin/ja/recent_rss.rb +34 -0
data/misc/plugin/ja/referer_scheme.rb +86 -0
data/misc/plugin/ja/search_control.rb +75 -0
data/misc/plugin/ja/search_form.rb +32 -0
data/misc/plugin/ja/tb-show.rb +38 -0
data/misc/plugin/ja/todo.rb +46 -0
data/misc/plugin/ja/weather.rb +402 -0
data/misc/plugin/ja/xmlrpc.rb +15 -0
data/misc/plugin/kw.rb +150 -0
data/misc/plugin/list.rb +40 -0
data/misc/plugin/makelirs.rb +89 -0
data/misc/plugin/makerss.rb +744 -0
data/misc/plugin/my-ex.rb +68 -0
data/misc/plugin/my-sequel.rb +539 -0
data/misc/plugin/navi_user.rb +19 -0
data/misc/plugin/number_anchor.rb +47 -0
data/misc/plugin/pb-show.rb +165 -0
data/misc/plugin/ping.rb +99 -0
data/misc/plugin/pre_wrap.rb +19 -0
data/misc/plugin/random_google.rb +165 -0
data/misc/plugin/recent_comment.rb +82 -0
data/misc/plugin/recent_comment3.rb +192 -0
data/misc/plugin/recent_list.rb +91 -0
data/misc/plugin/recent_namazu.rb +50 -0
data/misc/plugin/recent_rss.rb +305 -0
data/misc/plugin/referer-antibot.rb +53 -0
data/misc/plugin/referer-utf8.rb +12 -0
data/misc/plugin/referer_scheme.rb +87 -0
data/misc/plugin/search_control.rb +227 -0
data/misc/plugin/search_form.rb +53 -0
data/misc/plugin/sn.rb +107 -0
data/misc/plugin/speed_comment.rb +68 -0
data/misc/plugin/squeeze.rb +272 -0
data/misc/plugin/src.rb +30 -0
data/misc/plugin/tb-show.rb +212 -0
data/misc/plugin/title_list.rb +41 -0
data/misc/plugin/title_tag.rb +80 -0
data/misc/plugin/tlink.rb +163 -0
data/misc/plugin/todo.rb +182 -0
data/misc/plugin/weather.rb +505 -0
data/misc/plugin/whatsnew.rb +100 -0
data/misc/plugin/xmlrpc.rb +80 -0
data/misc/plugin/xmlrpc/README +20 -0
data/misc/plugin/xmlrpc/xmlrpc.rb +575 -0
data/misc/style/emptdiary/README.rd +83 -0
data/misc/style/emptdiary/README.rd.en +78 -0
data/misc/style/emptdiary/emptdiary_style.rb +199 -0
data/misc/style/etdiary/README.rd +83 -0
data/misc/style/etdiary/etdiary_style.rb +446 -0
data/misc/style/gfm/gfm_style.rb +194 -0
data/misc/style/rd/README.rd +71 -0
data/misc/style/rd/rd_style.rb +366 -0
data/misc/style/wiki/README +116 -0
data/misc/style/wiki/README.en +101 -0
data/misc/style/wiki/wiki_parser.rb +273 -0
data/misc/style/wiki/wiki_style.rb +478 -0
data/misc/theme_convert/Readme.rd +21 -0
data/misc/theme_convert/append.rcss +150 -0
data/misc/theme_convert/theme_convert.rb +453 -0
data/plugin/00default.rb +1015 -0
data/plugin/05referer.rb +298 -0
data/plugin/10spamfilter.rb +183 -0
data/plugin/50sp.rb +146 -0
data/plugin/60sf.rb +152 -0
data/plugin/90migrate.rb +109 -0
data/plugin/en/00default.rb +390 -0
data/plugin/en/05referer.rb +49 -0
data/plugin/en/10spamfilter.rb +81 -0
data/plugin/en/50sp.rb +56 -0
data/plugin/en/60sf.rb +60 -0
data/plugin/ja/00default.rb +401 -0
data/plugin/ja/05referer.rb +47 -0
data/plugin/ja/10spamfilter.rb +79 -0
data/plugin/ja/50sp.rb +66 -0
data/plugin/ja/60sf.rb +73 -0
data/public/.gitkeep +0 -0
data/public/images/.gitkeep +0 -0
data/public/javascripts/.gitkeep +0 -0
data/public/stylesheets/.gitkeep +0 -0
data/skel/category.rhtml +9 -0
data/skel/conf.rhtml +23 -0
data/skel/day.rhtml +33 -0
data/skel/diary.rhtml +83 -0
data/skel/footer.rhtml +8 -0
data/skel/header.rhtml +10 -0
data/skel/i.category.rhtml +6 -0
data/skel/i.conf.rhtml +14 -0
data/skel/i.day.rhtml +28 -0
data/skel/i.diary.rhtml +17 -0
data/skel/i.footer.rhtml +2 -0
data/skel/i.header.rhtml +3 -0
data/skel/i.latest.rhtml +24 -0
data/skel/i.month.rhtml +39 -0
data/skel/i.search.rhtml +5 -0
data/skel/i.update.rhtml +40 -0
data/skel/i.update.rhtml.en +40 -0
data/skel/latest.rhtml +27 -0
data/skel/mail.rtxt +18 -0
data/skel/mail.rtxt.en +18 -0
data/skel/month.rhtml +27 -0
data/skel/plugin_error.rhtml +27 -0
data/skel/preview.rhtml +85 -0
data/skel/preview.rhtml.en +72 -0
data/skel/referer.rhtml +24 -0
data/skel/search.rhtml +14 -0
data/skel/tdiary.rconf +76 -0
data/skel/update.rhtml +103 -0
data/skel/update.rhtml.en +83 -0
data/spec/acceptance/append_comment_spec.rb +94 -0
data/spec/acceptance/append_diary_spec.rb +98 -0
data/spec/acceptance/bugfix/encoding_error_spec.rb +27 -0
data/spec/acceptance/save_conf_comment_spec.rb +87 -0
data/spec/acceptance/save_conf_default_spec.rb +169 -0
data/spec/acceptance/save_conf_dnsbl_spec.rb +152 -0
data/spec/acceptance/save_conf_filter_spec.rb +50 -0
data/spec/acceptance/save_conf_plugin_spec.rb +69 -0
data/spec/acceptance/save_conf_referer_spec.rb +60 -0
data/spec/acceptance/save_conf_security_spec.rb +280 -0
data/spec/acceptance/support/helpers.rb +49 -0
data/spec/acceptance/support/paths.rb +7 -0
data/spec/acceptance/update_diary_spec.rb +113 -0
data/spec/acceptance/view_category_spec.rb +38 -0
data/spec/acceptance/view_comment_spec.rb +67 -0
data/spec/acceptance/view_diary_spec.rb +126 -0
data/spec/acceptance/view_referer_spec.rb +31 -0
data/spec/acceptance_helper.rb +101 -0
data/spec/core/compatible_spec.rb +54 -0
data/spec/core/core_ext_spec.rb +59 -0
data/spec/core/plugin_spec.rb +389 -0
data/spec/core/rack/assets/precompile_spec.rb +76 -0
data/spec/core/rack/html_anchor_spec.rb +57 -0
data/spec/core/rack/valid_request_path_spec.rb +67 -0
data/spec/core/style/emptdiary_style_spec.rb +165 -0
data/spec/core/style/etdiary_style_spec.rb +512 -0
data/spec/core/style/gfm_style_spec.rb +334 -0
data/spec/core/style/rd_style_spec.rb +202 -0
data/spec/core/style/tdiary_style_spec.rb +240 -0
data/spec/core/style/wiki_style_spec.rb +441 -0
data/spec/fixtures/ascii8bit-pstore.db +0 -0
data/spec/fixtures/invalid-sequence-volatile.tdr +9 -0
data/spec/fixtures/just_installed.conf +1 -0
data/spec/fixtures/plugin/ja/sample.rb +4 -0
data/spec/fixtures/plugin/sample.rb +6 -0
data/spec/fixtures/sample.rb +12 -0
data/spec/fixtures/tdiary.conf.gem +212 -0
data/spec/fixtures/tdiary.conf.rack +212 -0
data/spec/fixtures/tdiary.conf.rdb +227 -0
data/spec/fixtures/tdiary.conf.secure +204 -0
data/spec/fixtures/tdiary.conf.webrick +212 -0
data/spec/javascripts/00default_spec.js +35 -0
data/spec/javascripts/fixtures/00default.html +1 -0
data/spec/javascripts/support/jasmine.yml +76 -0
data/spec/plugin/bq_spec.rb +24 -0
data/spec/plugin/plugin_helper.rb +203 -0
data/spec/spec_helper.rb +32 -0
data/tdiary.conf.beginner +244 -0
data/tdiary.conf.sample +345 -0
data/tdiary.conf.sample-en +333 -0
data/tdiary.gemspec +26 -0
data/tdiary.rb +151 -0
data/tdiary/admin.rb +236 -0
data/tdiary/application.rb +57 -0
data/tdiary/author_only_base.rb +171 -0
data/tdiary/base.rb +220 -0
data/tdiary/cli.rb +116 -0
data/tdiary/comment.rb +40 -0
data/tdiary/comment_manager.rb +94 -0
data/tdiary/compatible.rb +72 -0
data/tdiary/config.rb +270 -0
data/tdiary/core_ext.rb +122 -0
data/tdiary/deploy.rb +50 -0
data/tdiary/dispatcher.rb +77 -0
data/tdiary/dispatcher/index_main.rb +122 -0
data/tdiary/dispatcher/update_main.rb +101 -0
data/tdiary/environment.rb +15 -0
data/tdiary/filter.rb +48 -0
data/tdiary/filter/default.rb +54 -0
data/tdiary/filter/spam.rb +304 -0
data/tdiary/io/base.rb +70 -0
data/tdiary/io/cache/file.rb +123 -0
data/tdiary/io/cache/memcached.rb +88 -0
data/tdiary/io/cache/redis.rb +100 -0
data/tdiary/io/default.rb +297 -0
data/tdiary/io/pstore.rb +252 -0
data/tdiary/io/rdb.rb +213 -0
data/tdiary/lang/en.rb +79 -0
data/tdiary/lang/ja.rb +72 -0
data/tdiary/plugin.rb +375 -0
data/tdiary/rack/assets/precompile.rb +37 -0
data/tdiary/rack/auth/basic.rb +38 -0
data/tdiary/rack/auth/omniauth.rb +51 -0
data/tdiary/rack/html_anchor.rb +31 -0
data/tdiary/rack/valid_request_path.rb +36 -0
data/tdiary/referer_manager.rb +80 -0
data/tdiary/request.rb +217 -0
data/tdiary/response.rb +29 -0
data/tdiary/server.rb +85 -0
data/tdiary/style.rb +194 -0
data/tdiary/style/tdiary_style.rb +198 -0
data/tdiary/style/wiki_style.rb +213 -0
data/tdiary/tasks.rb +1 -0
data/tdiary/tasks/assets.rake +31 -0
data/tdiary/tasks/auth.rake +28 -0
data/tdiary/tasks/db.rake +110 -0
data/tdiary/tasks/doc.rake +31 -0
data/tdiary/tasks/heroku.rake +37 -0
data/tdiary/tasks/jasmine.rake +16 -0
data/tdiary/tasks/rdoc.rake +24 -0
data/tdiary/tasks/release.rake +122 -0
data/tdiary/tasks/rspec.rake +51 -0
data/tdiary/tasks/server.rake +33 -0
data/tdiary/tasks/test.rake +17 -0
data/tdiary/version.rb +3 -0
data/tdiary/view.rb +468 -0
data/tdiary/view_helper.rb +15 -0
data/test/disp_referrer_test.rb +93 -0
data/test/my-sequel_test.rb +238 -0
data/test/test_helper.rb +7 -0
data/test/test_plugin_helper.rb +64 -0
data/test/test_plugin_helper_test.rb +28 -0
data/test/weather_test.rb +33 -0
data/theme/base.css +268 -0
data/theme/conf.block.png +0 -0
data/theme/conf.css +254 -0
data/theme/default/README +11 -0
data/theme/default/body.png +0 -0
data/theme/default/default.css +743 -0
data/theme/help.png +0 -0
data/theme/loading.gif +0 -0
data/theme/tdiary1/README +7 -0
data/theme/tdiary1/tdiary1.css +394 -0
data/theme/tdiary2/README +19 -0
data/theme/tdiary2/tdiary2.css +624 -0
data/update.fcgi +45 -0
data/update.rb +57 -0
data/vendor/hikidoc-0.0.6/COPYING +28 -0
data/vendor/hikidoc-0.0.6/NEWS +30 -0
data/vendor/hikidoc-0.0.6/NEWS.ja +30 -0
data/vendor/hikidoc-0.0.6/README +86 -0
data/vendor/hikidoc-0.0.6/README.ja +83 -0
data/vendor/hikidoc-0.0.6/Rakefile +68 -0
data/vendor/hikidoc-0.0.6/TextFormattingRules +320 -0
data/vendor/hikidoc-0.0.6/TextFormattingRules.ja +318 -0
data/vendor/hikidoc-0.0.6/bin/hikidoc +66 -0
data/vendor/hikidoc-0.0.6/lib/hikidoc.rb +914 -0
data/vendor/hikidoc-0.0.6/setup.rb +1360 -0
data/vendor/hikidoc-0.0.6/test/run-test.rb +13 -0
data/vendor/hikidoc-0.0.6/test/test_hikidoc.rb +506 -0
data/vendor/imagesize-0.1.1/Manifest.txt +19 -0
data/vendor/imagesize-0.1.1/README.txt +49 -0
data/vendor/imagesize-0.1.1/lib/image_size.rb +305 -0
data/vendor/imagesize-0.1.1/lib/image_size/version.rb +9 -0
data/vendor/imagesize-0.1.1/setup.rb +1585 -0
data/vendor/imagesize-0.1.1/test/2-4-7.png +0 -0
data/vendor/imagesize-0.1.1/test/4_1_2.gif +0 -0
data/vendor/imagesize-0.1.1/test/bmp.bmp +0 -0
data/vendor/imagesize-0.1.1/test/cursor.xbm +6 -0
data/vendor/imagesize-0.1.1/test/detect.swf +0 -0
data/vendor/imagesize-0.1.1/test/pbm.pbm +0 -0
data/vendor/imagesize-0.1.1/test/pcx.pcx +0 -0
data/vendor/imagesize-0.1.1/test/pgm.pgm +5 -0
data/vendor/imagesize-0.1.1/test/test.xpm +38 -0
data/vendor/imagesize-0.1.1/test/test_helper.rb +2 -0
data/vendor/imagesize-0.1.1/test/test_image_size.rb +71 -0
data/vendor/imagesize-0.1.1/test/tiff.tiff +0 -0
data/vendor/imagesize-0.1.1/test/tokyo_tower.jpg +0 -0
data/vendor/imagesize-0.1.1/test/tower_e.gif.psd +0 -0
data/vendor/jasmine-jquery-1.4.2/jasmine-jquery.js +548 -0
data/vendor/jquery-1.8/jquery.js +9227 -0
data/vendor/rdtool-0.6.38/COPYING.txt +339 -0
data/vendor/rdtool-0.6.38/Gemfile +3 -0
data/vendor/rdtool-0.6.38/HISTORY +318 -0
data/vendor/rdtool-0.6.38/LGPL-2.1 +502 -0
data/vendor/rdtool-0.6.38/LICENSE.txt +58 -0
data/vendor/rdtool-0.6.38/README.html +66 -0
data/vendor/rdtool-0.6.38/README.ja.html +73 -0
data/vendor/rdtool-0.6.38/README.rd +76 -0
data/vendor/rdtool-0.6.38/README.rd.ja +85 -0
data/vendor/rdtool-0.6.38/Rakefile +152 -0
data/vendor/rdtool-0.6.38/TODO +22 -0
data/vendor/rdtool-0.6.38/bin/rd2 +283 -0
data/vendor/rdtool-0.6.38/bin/rdswap.rb +207 -0
data/vendor/rdtool-0.6.38/doc/rd-draft.html +456 -0
data/vendor/rdtool-0.6.38/doc/rd-draft.ja.html +466 -0
data/vendor/rdtool-0.6.38/doc/rd-draft.rd +479 -0
data/vendor/rdtool-0.6.38/doc/rd-draft.rd.ja +487 -0
data/vendor/rdtool-0.6.38/lib/rd/block-element.rb +114 -0
data/vendor/rdtool-0.6.38/lib/rd/complex-list-item.rb +65 -0
data/vendor/rdtool-0.6.38/lib/rd/desclist.rb +55 -0
data/vendor/rdtool-0.6.38/lib/rd/document-struct.rb +46 -0
data/vendor/rdtool-0.6.38/lib/rd/dot.rd2rc +18 -0
data/vendor/rdtool-0.6.38/lib/rd/element.rb +160 -0
data/vendor/rdtool-0.6.38/lib/rd/filter.rb +255 -0
data/vendor/rdtool-0.6.38/lib/rd/head-filter.rb +14 -0
data/vendor/rdtool-0.6.38/lib/rd/inline-element.rb +233 -0
data/vendor/rdtool-0.6.38/lib/rd/labeled-element.rb +14 -0
data/vendor/rdtool-0.6.38/lib/rd/list.rb +57 -0
data/vendor/rdtool-0.6.38/lib/rd/loose-struct.rb +11 -0
data/vendor/rdtool-0.6.38/lib/rd/methodlist.rb +57 -0
data/vendor/rdtool-0.6.38/lib/rd/output-format-visitor.rb +30 -0
data/vendor/rdtool-0.6.38/lib/rd/package.rb +4 -0
data/vendor/rdtool-0.6.38/lib/rd/parser-util.rb +14 -0
data/vendor/rdtool-0.6.38/lib/rd/post-install +1 -0
data/vendor/rdtool-0.6.38/lib/rd/pre-setup.rb +18 -0
data/vendor/rdtool-0.6.38/lib/rd/rbl-file.rb +69 -0
data/vendor/rdtool-0.6.38/lib/rd/rbl-suite.rb +37 -0
data/vendor/rdtool-0.6.38/lib/rd/rd-struct.rb +86 -0
data/vendor/rdtool-0.6.38/lib/rd/rd2html-ext-lib.rb +266 -0
data/vendor/rdtool-0.6.38/lib/rd/rd2html-ext-opt.rb +34 -0
data/vendor/rdtool-0.6.38/lib/rd/rd2html-lib.rb +490 -0
data/vendor/rdtool-0.6.38/lib/rd/rd2html-opt.rb +67 -0
data/vendor/rdtool-0.6.38/lib/rd/rd2man-lib.rb +251 -0
data/vendor/rdtool-0.6.38/lib/rd/rd2rdo-lib.rb +19 -0
data/vendor/rdtool-0.6.38/lib/rd/rd2rmi-lib.rb +32 -0
data/vendor/rdtool-0.6.38/lib/rd/rdblockparser.ry +518 -0
data/vendor/rdtool-0.6.38/lib/rd/rdblockparser.tab.rb +1061 -0
data/vendor/rdtool-0.6.38/lib/rd/rdfmt.rb +15 -0
data/vendor/rdtool-0.6.38/lib/rd/rdinlineparser.ry +503 -0
data/vendor/rdtool-0.6.38/lib/rd/rdinlineparser.tab.rb +1243 -0
data/vendor/rdtool-0.6.38/lib/rd/rdvisitor.rb +214 -0
data/vendor/rdtool-0.6.38/lib/rd/reference-resolver.rb +114 -0
data/vendor/rdtool-0.6.38/lib/rd/search-file.rb +14 -0
data/vendor/rdtool-0.6.38/lib/rd/tree.rb +103 -0
data/vendor/rdtool-0.6.38/lib/rd/version.rb +41 -0
data/vendor/rdtool-0.6.38/lib/rd/visitor.rb +86 -0
data/vendor/rdtool-0.6.38/rdtool.gemspec +125 -0
data/vendor/rdtool-0.6.38/setup.rb +1596 -0
data/vendor/rdtool-0.6.38/test/data/includee1.html +1 -0
data/vendor/rdtool-0.6.38/test/data/includee2.html +1 -0
data/vendor/rdtool-0.6.38/test/data/includee3.nothtml +1 -0
data/vendor/rdtool-0.6.38/test/data/includee4.xhtml +0 -0
data/vendor/rdtool-0.6.38/test/data/label.rbl +2 -0
data/vendor/rdtool-0.6.38/test/data/label2.rbl +2 -0
data/vendor/rdtool-0.6.38/test/data/sub/includee2.html +1 -0
data/vendor/rdtool-0.6.38/test/data/sub/includee4.html +0 -0
data/vendor/rdtool-0.6.38/test/dummy-observer.rb +6 -0
data/vendor/rdtool-0.6.38/test/dummy.rb +33 -0
data/vendor/rdtool-0.6.38/test/temp-dir.rb +19 -0
data/vendor/rdtool-0.6.38/test/test-block-parser.rb +46 -0
data/vendor/rdtool-0.6.38/test/test-desclist-item.rb +219 -0
data/vendor/rdtool-0.6.38/test/test-document-element.rb +46 -0
data/vendor/rdtool-0.6.38/test/test-document-struct.rb +66 -0
data/vendor/rdtool-0.6.38/test/test-element.rb +46 -0
data/vendor/rdtool-0.6.38/test/test-headline.rb +80 -0
data/vendor/rdtool-0.6.38/test/test-inline-parser.rb +46 -0
data/vendor/rdtool-0.6.38/test/test-list-item.rb +54 -0
data/vendor/rdtool-0.6.38/test/test-list.rb +53 -0
data/vendor/rdtool-0.6.38/test/test-methodlist-item.rb +73 -0
data/vendor/rdtool-0.6.38/test/test-nonterminal-element.rb +170 -0
data/vendor/rdtool-0.6.38/test/test-nonterminal-inline.rb +33 -0
data/vendor/rdtool-0.6.38/test/test-output-format-visitor.rb +48 -0
data/vendor/rdtool-0.6.38/test/test-parser-util.rb +41 -0
data/vendor/rdtool-0.6.38/test/test-rbl-file.rb +156 -0
data/vendor/rdtool-0.6.38/test/test-rbl-suite.rb +43 -0
data/vendor/rdtool-0.6.38/test/test-rd2html-lib.rb +496 -0
data/vendor/rdtool-0.6.38/test/test-rdtree.rb +17 -0
data/vendor/rdtool-0.6.38/test/test-rdvisitor.rb +29 -0
data/vendor/rdtool-0.6.38/test/test-reference-resolver.rb +202 -0
data/vendor/rdtool-0.6.38/test/test-reference.rb +132 -0
data/vendor/rdtool-0.6.38/test/test-search-file.rb +22 -0
data/vendor/rdtool-0.6.38/test/test-terminal-inline.rb +41 -0
data/vendor/rdtool-0.6.38/test/test-textblock.rb +44 -0
data/vendor/rdtool-0.6.38/test/test-tree.rb +82 -0
data/vendor/rdtool-0.6.38/test/test-version.rb +57 -0
data/vendor/rdtool-0.6.38/test/test-visitor.rb +230 -0
data/vendor/rdtool-0.6.38/utils/rd-mode.el +464 -0
metadata +666 -0

data/vendor/rdtool-0.6.38/doc/rd-draft.rd.ja ADDED Viewed

@@ -0,0 +1,487 @@
+= RD working draft 日本語版
+英語版は((<ここ|URL:http://www.ruby-lang.org/~rubikitch/RDP-en.cgi?cmd=view&name=RD>))にあります。
+== RDとは何か
+RDとはRuby版のPODです。つまりRubyスクリプトファイルの中に埋め込む事を意図して
+定義されたドキュメントフォーマットです。
+RDは主にplain textをさまざまなフォーマットに変換するplain2というプログラム
+の影響を受けています。そのため、RDはplain textに似ており、シンプルですっきり
+した文法なので読みやすく書きやすいでしょう。
+== RubyインタプリタはRDをどのように扱うか
+Rubyのインタプリタは単純に"(({=begin}))"で始まる行から"(({=end}))"で始まる
+行までを無視します。ですから、スクリプトファイル中に埋め込む事ができるのは
+RDだけではありません。何でも(({=begin}))と(({=end}))の間に書く事ができるの
+です。RDは選択肢の一つにすぎませんが、Ruby標準のドキュメントフォーマットと
+されています。((-もし他のドキュメントフォーマットに興味があるなら、例えば
+rubyapi2
+((<URL:http://www.ueda.info.waseda.ac.jp/~igarashi/ruby/xml.html#rubyapi2>))
+などを見るといいでしょう。これはRuby/Gtkのような大規模ライブラリのドキュメン
+ト向けに作られています。-))
+== RDの基本的な概念と文法
+=== Element, Block, Inline
+これからの説明では"Element"という用語((-訳注: RDの文法用語についてはあ
+えて日本語訳をあてませんでした。-))をテキストに文章構造を与えるための
+構成要素という意味で用います。さらに、"((<Block>))"という用語を比較的
+大きくグローバルな構造を表すElementに、"((<Inline>))"という用語を比較的小さ
+くローカルな、テキストに付加的な修飾を与えるElementに対して用います。
+段落や見出し、リストなどがBlockです。RDではBlockを表すのに
+インデントや特殊文字を用います。Blockを入れ子にすることで複雑な
+構造も表現できます。そして、Blockの表現は自然とplain textに見え
+ます。詳しくは((<Block>))を見てください。
+強調やコードや参照などがInlineです。(('((? ... ?))'))のようなカッコと
+特殊文字の組合せがInlineの表現に使われます。ほとんどのInlineが互いに
+入れ子にできます。詳しくは((<Inline>))を見てください。
+=== Block
+==== 基本文法
+Blockは行指向の文法にしたがいます。つまり、同じ行にある文字はすべて同じ
+Blockに属しています。インデントはBlockの入れ子レベルとタイプを表して
+います。行の先頭の文字はBlockのタイプに関係します。
++ 概念と用語
+:Baseline
+  Baselineはインデントの基準です。ある行のインデントととBaselineの相対的
+  な深さはその行の属するBlockのタイプに影響します。
+:Head Char
+  Head Charは空白文字を除いた行の先頭の文字です。
+:STRINGLINE
+  STRINGLINEは普通の文字で構成された行です。STRINGLINEは"(({*}))",
+  "(({(((|num|)))}))", "(({:}))", "(({=}))", "(({+}))"といった文字を
+  Head Charとしては含みません。しかし、インデントされた行なら"(({=}))"
+  や"(({+}))"をHead Charとすることができます。
+:WHITELINE
+  WHITELINEは空白文字だけの行です。
+:Comment
+  (({/^#/}))にマッチする行はコメントとみなされます。
++ Baselineの決定と影響
+トップレベルでは((<Baseline>))は行の左端です。リスト内ではBaselineはListItem
+の最初の((<Block>))によって決定します。例えば、
+  Example: "|" はBaselineを表しています。
+    |この行はトップレベルのTextBlockの行だとします。
+    |<- したがって、Baselineは左端です。
+      *|List内では (1)
+       |<- このようにBaselineは(1)の行で決定されます。
+      *    |同じListでもListItem毎にBaselineが決定されます。
+           |<- したがって、1番目のListItemとは違うここにBaselineがあります。
+|この行はトップレベルのTextBlockの行だとします。
+|<- したがって、Baselineは左端です。
+  *|List内では (1)
+   |<- このようにBaselineは(1)の行で決定されます。
+  *    |同じListでもListItem毎にBaselineが決定されます。
+       |<- したがって、1番目のListItemとは違うここにBaselineがあります。
+Blockが別のBlockに入れ子になっている時には内部のBlockのBaselineは外側の
+BlockのBaselineよりも深くなります。
+Baselineとインデントの相対的な位置関係がBlockのタイプに影響します。
+Baselineと同じ深さにインデントされた((<STRINGLINE>))は((<TextBlock>))
+に属す行となります。一方Baselineより深くインデントされた((<STRINGLINE>))
+は((<Verbatim>))の行です。
+==== Blockのタイプ
++ Headline
+Headlineは"(({=}))"か"(({+}))"を((<Head Char>))とする行で構成されます。
+Headlineは1行以上にはなりません。Headlineはトップレベルだけに置く事が
+できます。
+  Example:
+  |<- トップレベルのBaseline
+  = Headline 1.
+  === Headline 1.1.1.
+  + Headline 1.1.1.1.1.
+= Headline 1.
+=== Headline 1.1.1.
++ Headline 1.1.1.1.1.
+Headlineの先頭の特殊文字はHeadlineのレベルを表しています。次の図で
+最初のマークは最も大きなレベルのもので、最後のマークがもっとも小さな
+レベルのものです。
+  Fig: Headline Marks
+  =
+  ==
+  ===
+  ====
+  +
+  ++
+マークに続くテキストはHeadlineのタイトルです。これは同時に
+((<Reference>))のラベルとして使われます。
+Headlineのタイトルには((<Reference>))とFootnoteを除く((<Inline>))を使う事が
+できます。
++ Include
+Includeは"(({<<<}))"を((<Head Char>))とし、その後ろにインクルードする
+ファイルの名前が続く行からなります。RD形式のファイルと出力するフォーマッ
+トで書かれたファイルのどちらでもIncludeによってインクルードできます。
+RD形式のファイルをインクルードする時にはインクルードされるファイルの名
+前は"foo.rd"の様に".rd"もしくは".rb"というサフィックスでなくてはなりま
+せん。そして、"(({<<<}))"の後にはサフィックスを含めたファイルの完全な
+名前を書きます。例えば、次の様にです。
+  <<< foo.rd
+出力するフォーマットのファイルをインクルードするには、インクルードされる
+ファイルはその出力フォーマットに固有のサフィックスを持たないといけません。
+例えば、HTMLのファイルをインクルードするには".html"というサフィックスを、
+Texinfo形式のファイルをインクルードするには".texi"というサフィックスを
+つけます。そして、"(({<<<}))"の後ろにはサフィックスを除いたファイルの
+名前を書きます。例えば、
+  <<< foo
+と書くわけです。
+この場合、RDフォーマッタはHTMLを出力する時には"foo.html"をインクルード
+し、Texinfo形式で出力する時には"foo.texi"をインクルードします。出力フォー
+マットのIncludeを用いる時には複数の(しかもなるべく多くの)形式のインク
+ルードファイルを用意すべきです。
++ TextBlock
+TextBlockは複数の((<STRINGLINE>))から構成されます。それらの行は((<Baseline>))
+と同じインデントでないといけません。((<Baseline>))より深い((<STRINGLINE>))は
+((<Verbatim>))の行とみなされます。
+TextBlockは((<Inline>))を内部に含む事ができます。
+  Example:
+  |
+  これはTextBlockです。
+  TextBlockの2行目の行です。
+    この行はTextBlockでなくVerbatimです。
+  * そしてこの行はListの行です。(正確にはListItemの中のTextBlockの行でも
+    あるのですが)
+この例は次のようにフォーマットされます。
+これはTextBlockです。
+TextBlockの2行目の行です。
+  この行はTextBlockでなくVerbatimです。
+* そしてこの行はListの行です。(正確にはListItemの中のTextBlockの行でも
+  あるのですが)
++ Verbatim
+Rubyスクリプトを引用するのにVerbatimを用いる事ができます。Verbatimは
+((<Baseline>))より深いインデントを持つ((<STRINGLINE>))で構成されます。
+Verbatimは"(({*}))"や"(({(1)}))"や"(({:}))"といった特殊文字を((<Head
+Char>))として持つ行も含む事ができますが、それらは最初の行には置く事
+ができません。最初の行にあるときには((<List>))と見なされます。Verbatim
+は最初の行より浅いインデントの行も含みません。Verbatimは((<WHITELINE>))
+を含める事ができます。
+((<Inline>))はVerbatim内では使えません。
+ Example:
+  これはVerbatimです。
+    最初の行より深いインデントを持っても、同じVerbatimの行になります。
+  * この行はListに見えますが、Verbatimです。
+ しかしこの行は最初の行よりも浅くインデントされているので、別のVerbatim
+ の行になります。
+この例が次のようにフォーマットされます。
+  これはVerbatimです。
+    最初の行より深いインデントを持っても、同じVerbatimの行になります。
+  * この行はListに見えますが、Verbatimです。
+ しかしこの行は最初の行よりも浅くインデントされているので、別のVerbatim
+ の行になります。
++ List
+Listは特殊な((<Block>))です。Listは複数のListItemから構成され、ListItem
+は複数のBlockから構成されます。したがって、ListはBlockを内部に含む事が
+できます。含む事のできるBlockにはList自身も含みます。((-((<Headline>))
+や((<Include>))はList内部に持てません。-))
+ListItemは((<WHITELINE>))を含む事ができますが、((<TextBlock>))は
+持てません。そのため、WHITELINEを間にはさむ事によって複数のTextBlock
+をListItem内部に置く事ができます。
+Listには"((<ItemList>))"、"((<EnumList>))"、"((<DescList>))",
+"((<MethodList>))の4種類があります。
+++ ItemList
+ItemListは単純な番号付されないListです。ItemListItemは"(({*}))"という
+((<Head Char>))の行で始まります。ItemListItemの最初のBlockは必ず
+((<TextBlock>))になります。
+  Example:
+  * 親Listの最初のItem
+      * 子Listの最初のItem
+      * 子Listの2番目のItem
+    親ListのItemに含まれるTextBlock
+下のようにフォーマットされます。
+  * 親Listの最初のItem
+      * 子Listの最初のItem
+      * 子Listの2番目のItem
+    親ListのItemに含まれるTextBlock
+++ EnumList
+EnumListは番号付されたListです。EnumListItemは"(({((|num|))}))"(((|num|))
+は整数)という((<Head Char>))の行ではじまります。他の点ではEnumListは
+((<ItemList>))と同じです。
+  Example:
+  (1) 親Listの最初のItem
+        * 子ListとなるItemList
+  (2) 親Listの2番目のItem
+  (10) 番号は無視されます。
+次のようにフォーマットされます。
+  (1) 親Listの最初のItem
+        * 子ListとなるItemList
+  (2) 親Listの2番目のItem
+  (10) 番号は無視されます。
+++ DescList
+DescListは用語説明のためのListです。DescListItemは2つの部分からなります。
+1つはTermパートでもう1つはDescriptionパートです。Termパートは((<Reference>))
+のLabelとして使われます。
+Termパートは"(({:}))"という((<Head Char>))の行からなります。Termパートの
+行はインデントできることを除くとTermパートは((<Headline>))と同様です。
+DescriptionパートはTermパートの次の行からはじまります。Descriptionパート
+の((<Baseline>))はTermパートの(((<Head Char>))を除いた)テキスト部分と
+同じかより深くないといけません。例えば次の例は間違っています。
+  Example:
+  :   |Term
+    |Description.
+Descriptionぱーとは複数の((<Block>))を含む事ができます。((<List>))を
+最初のBlockとすることもできます。Termパートは((<Inline>))を含む事が
+できますが、((<Reference>))とFootnoteは例外です。
+  Example:
+  :Term
+     Descriptionの最初の行
+     2番目の行
+  :Term2
+     * Listも含む事ができます
+     * ...
+次のようにフォーマットされます。
+  :Term
+     Descriptionの最初の行
+     2番目の行
+  :Term2
+     * Listも含む事ができます
+     * ...
+++ MethodList
+MethodListはメソッドの説明のための特殊なタイプの((<DescList>))です。
+ほとんどの点でMethodListは((<DescList>))と同様ですが、Labelの規則
+は違っています。RDフォーマッタはMethodListのTermパートがなんらかの
+Rubyのあるクラスのメソッドや定数やCの関数プロトタイプといったような
+プログラムのコードであると知っています。そのため、MethodListは
+メソッドの引数のように見える部分を除いた上でLabelとなります。詳細は
+((<LabelとReference>))を見てください。
+MethodListItemは((<DescList>))と同様にTermパートとDescription
+パートを持ちます。Termパートは"(({---}))"という((<Head Char>))
+の行でなり、Descriptionパートは((<TextBlock>))や((<Verbatim>))
+、((<List>))を含む事ができます。しかし、逆にMethodListを((<List>))
+の中に置くべきではありません。RDは将来的にはこれを禁止するかも
+しれません。
+  Example:
+  --- Array#each {|i| ... } # => Labelは"Array#each"
+        各項目に対してブロックを評価する。
+  --- Array#index(val) # => Labelは"Array#index"
+        ((|val|))と同じ値である最初の項目を返す。同じ項目が無いときには
+        (({nil}))を返す。
+この例が次のようにフォーマットされます。
+  --- Array#each {|i| ... }
+        各項目に対してブロックを評価する。
+  --- Array#index(val)
+        ((|val|))と同じ値である最初の項目を返す。同じ項目が無いときには
+        (({nil}))を返す。
+フォーマッタのいくつかはMethodListのTermパートに書かれているのはRuby
+のメソッドや定数などであると仮定しています。そういったフォーマッタでは
+MethodListのTermパートをインテリジェントに扱う事ができますが、そのため
+には特定の慣習にしたがってRDを書く必要があります。
+標準的なRubyクラスリファレンスのための慣習として次のようなものが提案さ
+れています。
+  : インスタンスメソッド
+      クラス((|Class|))のインスタンスメソッド((|method|))
+        Class#method(its params  ...) { parameter block }
+  : クラスメソッド(クラスの特異メソッド)
+      クラス((|Class|))のクラスメソッド((|method|))
+        Class.method(its params ...) { parameter block }
+  : クラス定数
+      クラス((|Class|))の定数((|Const|))
+        Class::Const
+  : 関数メソッド
+      関数((|func|))
+        function#func(its params ...) { parameter block }
+Rubyはいくつかの特殊な文字(e.g. [], []=, +, -, <<, ...)はメソッドの名前
+(識別子)として使います。この時、Rubyインタプリタはこれらのメソッドの
+パースを普通のメソッドとは違ったやりかた(演算子メソッド)で行います。
+しかし、この慣習ではこれらの演算子メソッドも同じように書きます。
+  Example:
+    --- Array#[](key)
+          ((|key|))に対応する値を返す。
+    --- Array#[]=(key, value)
+          ((|key|))の場所に((|value|))を格納する。
+    --- Array#+(other)
+          2つの(({Array}))を結合してそれを返します。
+=== Inline
+Inlineは((<TextBlock>))や((<Headline>))、((<DescList>))のTermパートの
+中で使う事ができます。カッコを使ったマークアップがInlineに使われます。
+Inline同士は互いに入れ子にできます。
+次のInlineの一覧では左側に書式を、右側にフォーマット後の様子を表示
+しています。
+:(('((*Em*))')) => ((*Em*))
+    強調
+:(('(({while gets...}))')) => (({while gets...}))
+    プログラムのコード
+:(('((|var|))')) => ((|var|))
+    メタ変数((- Varについての詳しい説明はtexinfo.texiの該当部分にあります。-))
+:(('((%ruby -v%))')) => ((%ruby -v%))
+    キーボード
+:(('((:Term:))'))
+    => ((:Term:))
+    インデクスやキーワードとなる用語の指定
+:(('((<Identity or URL>))'))
+    => ((<Indentity or URL>))
+    参照。詳しくは((<LabelとReference>))を見てください。
+:(('((-Footnote-))'))
+    => ((-Footnote-))
+    脚注
+:(('(('verb\'))')) => (('verb'))
+    Inlineのvarbatim(フォーマット抑制)
+==== LabelとReference
+ReferenceにはLabelが必要です。RDでは((<Headline>))のタイトルと((<DescList>))
+や((<MethodList>))のTermパートだけがLabelとなります。したがって、各々の
+((<Headline>))には違うタイトルをつけてあげなくてはなりません。この問題の
+きちんとした解決策はまだ見付かっていません。
++ どのようにLabelがつけられるか
+((<Headline>))のタイトルと((<DescList>))や((<MethodList>))のTermパートが
+Labelとして使われます。しかし、((<Inline>))が含まれるために、それらが
+そのままLabelとして使われる、というほど単純ではありません。
+第一に、((<MethodList>))はLabel付けにおいてはやや特殊です。((<MethodList>))
+のTermパートは((<Inline>))を含みませんが、その代わりRDでは((<MethodList>))
+のTermパートはメソッドリファレンスやそれに類似の物とみなされますので、次の
+ようなルールでラベルが付けられます。
+  (1) "(({(}))"や"(({{}))"の前にあるテキストだけがラベルと見なされる。((-
+      "(({(...)}))"の内部のテキストはメソッドの引数だと見なされ、
+      "(({{...}}))"の内部のテキストはメソッドのブロックと見なされるのです。-))
+次の例を見れば、どのようにルールが適用されているかわかるでしょう。
+"(({# =>}))"より右にあるのが((<MethodList>))のTermパートから抽出された
+Labelです。
+  Example:
+    --- Array.new([size[, val]]) # => Array.new
+    --- Array#[]=(key, val) # => Array#[]=
+    --- Array#each { ... } # => Array#each
+    --- void rb_define_method(VALUE class, ...) # => void rb_define_method
+次に、((<Headline>))のタイトルや((<DescList>))のTermパートの場合には、この
+ような特別なルールはありませんが、((<Inline>))を含む事があるので、((<Inline>))
+に用いるカッコを取り除くためのルールがあります。
+  (1)どんな((<Inline>))修飾もLabelには影響しません。したがって、
+        = ((*Headline*))
+      と
+        = Headline
+      は共に"Headline"とLabelが決まります。
+  (2)しかし、Labelを抽出する際には((<Inline>))の開始カッコの後ろと終端カッコ
+     の前にある空白文字は取り除かれます。したがって、
+        = ((* Headline  *))
+     も
+        = ((*Headline*))
+     も"Headline"とLabelがつけられます。
++ Reference
+LabelのつけられたElementはReferenceによって参照できます。Referenceは
+(('((<...>))'))というカッコで修飾される((<Inline>))です。
+最も簡単なReferenceの使用法は、単にLabelをそのカッコの中に書けばよいのです。
+  ((<Label>))
+これは"Label"というLabelに対する参照となります。また、フォーマッタによる
+出力では"Label"というテキストが表示にも使われます。例: ((<Label>))((-
+"Label"というLabelのついたElementが無いのでおそらくReferenceの様には
+見えないでしょう。-))
+URLによって示されたリソースを参照するには次のように書きます。
+  ((<URL:http://www.ruby-lang.org/en/raa.html>))
+可能ならRDフォーマッタはURLを次のようにハイパーリンクします。例:
+((<URL:http://www.ruby-lang.org/en/raa.html>)).
+Labelとは違うテキストを表示に使いたい時には次のように書きます。
+  ((<Text for display|Label>))
+"Text for display"が表示用のテキストとして使われ、"Label"がLabelとして
+使われます。例: ((<Text for display|Label>))
+表示用のテキストは((<Inline>))を含む事ができます。しかし、Footnoteと
+Reference自身を含む事はできません。
+Reference内では"|"や"/"は特殊文字なのでこれらを使いたい時には、それを含む
+部分ごとダブルクオートで囲ってやらないといけません。これはReference内のどの
+部分でも同じです。
+   ((<"Bar | inside display text"|Label>))
+((<"Bar | inside display text"|Label>))
+表示用のテキストはURLへのReferenceにも使う事ができます。
+   ((<Ruby Application Archive|URL:http://www.ruby-lang.org/en/raa.html>))
+((<Ruby Application Archive|URL:http://www.ruby-lang.org/en/raa.html>))
+表示用のテキストが無い場合には代わりにLabelに((<Inline>))を使えます。
+   ((<((*Label*))>))
+((<((*Label*))>))