From: kjana@... (YANAGAWA Kazuhisa) Date: 2000-04-21T21:04:24+09:00 Subject: [ruby-list:22046] Re: rd2man In message <200004210115.KAA18226@mail.yb3.so-net.ne.jp> toshirok@yb3.so-net.ne.jp writes: > RDtool自体のバグフィックスをして週末に0.6.1を出したいです。 > その時にrd2manもいれさせていただくつもりです。 > # できれば日本語のdoc/rd-draft.rdもその時にどうにかしたいです。 英語のドキュメントもいくつか何とかした方がよろしいかと．単なる typo レ ベルの話ですけど． # あと README.rd の `somebody elses'． 英語でのドキュメント書きのおともに ispell をどうぞ，っていうか．あれ， ものすごく便利です． # typo チェックのつもりで余計に typo いれてたらごめんなさい :-P *** rd-draft.rd.orig Sat Apr 8 02:25:09 2000 --- rd-draft.rd Sat Apr 8 02:32:52 2000 *************** *** 13,17 **** ! Ruby's interpreter, (({ruby})), simply ignores texts bitween a line beginning ! with "(({=begin}))" and one beggining with "(({=end}))". So, not only RD is ! embedable. You can write anything bitween (({=begin})) and (({=end})). RD is one of them, but RD will be a standard one.((- If you are interested in others, --- 13,17 ---- ! Ruby's interpreter, (({ruby})), simply ignores texts between a line beginning ! with "(({=begin}))" and one beginning with "(({=end}))". So, not only RD is ! embedable. You can write anything between (({=begin})) and (({=end})). RD is one of them, but RD will be a standard one.((- If you are interested in others, *************** *** 21,26 **** ! == Consepts and Syntax === Element, Block and Inline ! We will use a term "Element" for features of RD which add imformation of document structure to text. In addition, we use a term "Block" for elements --- 21,26 ---- ! == Concepts and Syntax === Element, Block and Inline ! We will use a term "Element" for features of RD which add information of document structure to text. In addition, we use a term "Block" for elements *************** *** 34,36 **** ! Emphasis, Code, Reference is a Inline. Parentheses and supecial characters, like (('((? ... ?))')), are used for Inline. Almost all Inline can nest each --- 34,36 ---- ! Emphasis, Code, Reference is a Inline. Parentheses and special characters, like (('((? ... ?))')), are used for Inline. Almost all Inline can nest each *************** *** 48,50 **** :Baseline ! Baseline is standard depth of indent. relative depth bitween indent of one line and Baseline affects type of its Block. --- 48,50 ---- :Baseline ! Baseline is standard depth of indent. relative depth between indent of one line and Baseline affects type of its Block. *************** *** 65,67 **** + How Baseline is defined and How its works ! In top level, Baseline is at leftend, indent 0. In List, Baseline is defined by first Block of ListItem. For example, --- 65,67 ---- + How Baseline is defined and How its works ! In top level, Baseline is at left end, indent 0. In List, Baseline is defined by first Block of ListItem. For example, *************** *** 167,169 **** Verbatim, it is regarded as (()). Verbatim can't include a line ! which is indented sharrower than first line. Verbatim can include (()). --- 167,169 ---- Verbatim, it is regarded as (()). Verbatim can't include a line ! which is indented shallower than first line. Verbatim can include (()). *************** *** 173,175 **** Example: ! This is Verbaim. Even if a line is indented deeper than first line, it is also in same --- 173,175 ---- Example: ! This is Verbatim. Even if a line is indented deeper than first line, it is also in same *************** *** 177,179 **** * A line seems like list is also included in Verbatim. ! But if the line is indented sharrower, it is not in same Verbatim. It is in other Verbatim. --- 177,179 ---- * A line seems like list is also included in Verbatim. ! But if the line is indented shallower, it is not in same Verbatim. It is in other Verbatim. *************** *** 182,184 **** ! This is Verbaim. Even if a line is indented deeper than first line, it is also in same --- 182,184 ---- ! This is Verbatim. Even if a line is indented deeper than first line, it is also in same *************** *** 186,188 **** * A line seems like list is also included in Verbatim. ! But if the line is indented sharrower, it is not in same Verbatim. It is in other Verbatim. --- 186,188 ---- * A line seems like list is also included in Verbatim. ! But if the line is indented shallower, it is not in same Verbatim. It is in other Verbatim. *************** *** 197,199 **** include WHITELINE, so when you want to write 2 TextBlock inside ! ListItem, put a WHITELINE bitween TextBlocks. --- 197,199 ---- include WHITELINE, so when you want to write 2 TextBlock inside ! ListItem, put a WHITELINE between TextBlocks. *************** *** 252,254 **** Description part must be deeper than term of Term part of its pair. ! For example, following style is irregal. Example: --- 252,254 ---- Description part must be deeper than term of Term part of its pair. ! For example, following style is illegal. Example: *************** *** 263,265 **** first line of definition. ! second line of defnition :Term2 --- 263,265 ---- first line of definition. ! second line of definition :Term2 *************** *** 272,274 **** first line of definition. ! second line of defnition :Term2 --- 272,274 ---- first line of definition. ! second line of definition :Term2 *************** *** 292,294 **** (()) and (()). But you shouldn't write MethodList ! in any kind of (()). RD will come to deny it possiblly in future. --- 292,294 ---- (()) and (()). But you shouldn't write MethodList ! in any kind of (()). RD will come to deny it possibly in future. *************** *** 298,300 **** yield block for each item. ! --- Array#index(val) # => labeld as "Array#index" return index of first item which equals with ((|val|)). if it hasn't --- 298,300 ---- yield block for each item. ! --- Array#index(val) # => labeled as "Array#index" return index of first item which equals with ((|val|)). if it hasn't *************** *** 306,308 **** yield block for each item. ! --- Array#index(val) # => labeld as "Array#index" return index of first item which equals with ((|val|)). if it hasn't --- 306,308 ---- yield block for each item. ! --- Array#index(val) # => labeled as "Array#index" return index of first item which equals with ((|val|)). if it hasn't *************** *** 312,314 **** is in term part of MethodList. it can format term part of MethodList ! intelligentlly, but you have to write according as specific formula to make the best of its feature. --- 312,314 ---- is in term part of MethodList. it can format term part of MethodList ! intelligently, but you have to write according as specific formula to make the best of its feature. *************** *** 382,384 **** Title of (()) and term part of (()) and (()) ! are regared as Label. But they can contain (())s, so the situation isn't so simple. --- 382,384 ---- Title of (()) and term part of (()) and (()) ! are regarded as Label. But they can contain (())s, so the situation isn't so simple. *************** *** 449,451 **** ! Ofcourse, you can use display text part for Reference to URL resource. (()) --- 449,451 ---- ! Of course, you can use display text part for Reference to URL resource. (()) -- 柳川和久 @ 東大阪市 . 大阪府 April 21, 2000 「どうせ私は一生少女海賊よーっ」 「一生少女ってのもずうずうしいけどな」