なかのにっき

• OSWG の index ページ にはすでに LDP 文書も含めたリストがあるけど. OSWG には Linux specific でない文書もあるし, 逆ミラーは不要では? あと, LDP に置くことに関してライセンスが心配なんだけど, LDP 文書は LDP License または Boilerplate License でカバーされることが 必須なのか? (Deb Richardson)
  
  検索に引っかかると嬉しいと思う (Aznar, Ferguson)
  
  
• ライセンスについては manifesto にある通り、独自ライセンスの文書も認めている (Ferguson)
  
  ただし無料で再配布可能でないとダメだよ (Lawyer)
  
  
• リンクだけじゃだめなの? (Kendall Clark)
  
  速度的にミラーが嬉しいでは. 検索システムのインデクシングも楽になるし.
  一般にリンクよりは文書そのものを持ってきて管理するほうが楽だ (Ferguson)
  
  
• web にアクセスできないエンドユーザのことを考えると, 文書はまとめてパッケージしてあるほうが嬉しいのでは. distirubtion に入っている文書が obsolete になってることも多い. パッケージをより流通させることを考えていいのでは (Gjoen)
  
  もう OSWG のパッケージングの計画はあるかと思う (Dawson)
  
  /usr/doc/HOWTO と /usr/doc/OSWG に散ってるのは嬉しくない. まとめたパッケージになってていいんじゃないだろうか.
  多数の distribution のうちのどのくらいがここのリストを意識してくれてるんだろう? 文書の fresh な流通を確保するには、 LDP で .deb とか .rpm とかをつくることを考えてもいいかもしれない(Gjoen)
  
  ディレクトリ構成に関しては、LDP が考えなくてもいいと思う。 まとめて /usr/doc/HOWTO に置くのはパッケージャに任せていいのでは. (Dawson, Rubini)
  
  でも現実的にパッケージで文書がちゃんと流通していないというのも 確かなんだが... (Dawson)
  
  
• サイト全体をミラーするのではなくて、 ピックアップした文書に対してミラーを行うつもり。 non-free のはミラーしないように気をつける (Aznar)
  
  
• ユーザに対して "Linux Documentation Project" が二つあるのは 良くないと思う. OSWG と LDP は協力しつつも差別化すべきでは. (Lawyer)
  
  多様性を認めるべき. 著者側には選択の自由がある. (Dawson, Fawcett)
  
  自分は LDP が沈滞したから OSWG に移ったし, OSWG のやり方に満足してるが (Vuksan)

BOILERPLATE LICENSE

Here is a sample copyright notice and``boilerplate'' license you may
want to use for your work:

Copyright (c) 2000 by John Doe (change to your name)

Please freely copy and distribute (sell or give away) this document
in any format.
- Forward any corrections and comments to the document maintainer.
+ It's requested that corrections and/or comments be fowarded to
+ the document maintainer.
  You may create a derivative work and distribute it provided that you:

1. Send your derivative work (in the most suitable format such as
  sgml) to the LDP (Linux Documentation Project) or the like for posting
  on the Internet.  If not the LDP, then let the LDP know where it is
  available.
- Except for translations, send a copy to the previous
- maintainer's url as shown in the latest version.
2. License the derivative work with this same license or use
  GPL.  Include a copyright notice and at least a pointer to the
  license used.
3. Give due credit to previous authors and major contributors.

If you're considering making a derived work other than a
translation, it's requested that you discuss your plans with the
current maintainer.

• 音は前のより随分静かになった。 しかし良くある高音の回転音の他に、 「カサカサ、カサカササ」という感じの periodic でない 妙なかすれ音が聞こえる。
• 取りつけるフランジと机までの距離が、ポンプの高さにぎりぎりなので、 4 つある底面のゴム足が一つ机に接触している。 動作上の問題はないようだが、機会があったら一つ外しておくとよいだろう。 以前のポンプもゴム足が一つなくなっていた。
• 取付のボルトのワッシャが 3 つ足りない。 いかんのは承知で、そのまま付けてしまった。
• 冷却水の導入用とおぼしきタケノコがついていたが、 マニュアルには「特殊な場合を除いて水冷は不要」 とあったので OK とする。要確認。

A two-dimensional hybrid model for an electron cyclotron resonance (ECR) plasma reactor is improved by taking into account the microwave absorption. With this code, the velocity and angle distribution function of ions in the source and downstream areas, and the ion current density at the substrate surface in an extended ECR plasma reactor were investigated.

• 同意。それに linuxdoc → DocBook の乗り換えに遅れた時点で、 個人的には LDP に関する興味を失ってしまった (David Mason)
  
  
• この議論は建設的でない。こんなのばっかりなら ML やめたい (jdanield@free.fr)
  
  ちがう、逆にこういうのが大事なんだ。文書を大事にする著者は多いが、 文書プロジェクトを大事にしてくれる著者は少ない。文句があるなら ちゃんと言わないと物事は前進しない。
  DocBook に関して言うなら Godoy がいろいろ準備中だよ (Aznar)

• 著者でなく読者に焦点を置くなら、著者の方でトラブルになるのは当然だ。 自分の興味が持てない方向に進んでいるプロジェクトを助けるのは 気が進まない。だから自分は LDP を手伝うつもりもない。(Dawson)
  
  それはかまわないし当然のことだが、なら volunteer のやっている 方向に対して文句を言うのもやめてほしい (Aznar)
  
  
• プロジェクトを help しないといってるが、 文書を書くこと自体が大きな contribute なのでは？ 常に文書が第一、他のことは二の次、のはずだ。(Deb Richardson)
  
  公開されなきゃ文書には価値がない。お互いを尊重すべきで、 誰が第一とか考えるべきではないだろう (cogNiTioN)

• なんで FAQ 用の manifesto とかが別にいるの？ 今あるのをベースに FAQ-HOWTO を作ればいいのでは？ あるいは HOWTO-HOWTO とマージして Howto/FAQ-HOWTO にするとか。(Lawyer)
  
  別に作る、と言うつもりではなく、それら (既存の) 情報を集めて 著者向けのガイドを作る、と言うつもりだった。
  FAQ HOWTO にしましょ。(Aznar)

homepage: Linux Documentation Project <our url>
contact:  Guylhem Aznar <his email>

Description:
The Linux Documentation Project is an informal organization of
volunteers writing documentation for the GNU/Linux Operating System.
We have written about 140 HOWTOs and numerous other documents.  These
are distributed at over 200 mirror sites worldwide.

Documentation Needs:
We need more people to write and review documentation.  Other projects
include integration of GNU/Linux documentation and improving our
website.  See "Volunteers" on our homepage and our "Howto-HOWTO".

• 一つのライセンスに複数のオプションがあってもいいけど、 その内のどれかが承認できない場合には、 そのライセンスを人に勧める気にはなれない - きっと間違ってそれを選んじゃうだろうから。
• 二つのライセンスを持った文書を統合することの難しさが言及されていたけど、 オプションの違うのを統合するのだって同じくらい難しいのでは？
• 著者が認めればどうこうできる、という議論はナンセンスだ。 ライセンスは「著者が認めなくても」できることを記述しているところに 意味があるのだから。

• 賛成。イメージ自体出さないようにしてもいいかも。 (Gregory Leblanc)
  
  アイコンを使わないなら sgml2html で -I オプションを指定しなければ良い。 PNG に変えるなら、以下のパッチを当てればいい。(佐野さん)

  --- ../../build/sgml-tools-1.0.9/lib/SGMLTools/Html2Html.pm     Sat Jan 29 19:49:51 2000
  +++ lib/SGMLTools/Html2Html.pm  Fri Feb  4 10:16:02 2000
  @@ -263,7 +263,7 @@
  
       # Next link (first)
       my $next = $use_imgs
  -                  ? qq(<IMG SRC="next.gif" ALT="$nextlabel">)
  +                  ? qq(<IMG SRC="next.png" ALT="$nextlabel">)
                     : qq($nextlabel);
       $next = qq(<A HREF="$firstname-$myfilenum.$fileext">$next</A>)
          if ($myfilenum < $filecount);
  @@ -272,7 +272,7 @@
  
       # Previous link
       my $prev = $use_imgs
  -                  ? qq(<IMG SRC="prev.gif" ALT="$prevlabel">)
  +                  ? qq(<IMG SRC="prev.png" ALT="$prevlabel">)
                     : qq($prevlabel);
       $prev = join "", qq(<A HREF="$firstname-), ($myfilenum - 2),
                        qq(.$fileext">$prev</A>)
  @@ -282,7 +282,7 @@
  
       # Table of contents link
       my $toc = $use_imgs
  -                ? qq(<IMG SRC="toc.gif" ALT="$toclabel">)
  +                ? qq(<IMG SRC="toc.png" ALT="$toclabel">)
                   : qq($toclabel);
       $toc = join "", qq(<A HREF="$firstname.$fileext#toc),
                       &section_num($secnr, 0), qq(">$toc</A>)
  

  
  
  それをデフォルトにしてくれる？ jpg の方がいいかな。 PNG をサポートしてないブラウザもあるかもしれないし。(Aznar)
  
  いや、矢印みたいなのには PNG の方が向いてるだろう。 いまさら PNG をサポートしないブラウザもないと思うが。 (Leblanc)
  
  私は sgml のメンテナじゃなくて現在はパッチ作成者だ。 sgmltools のプロジェクトが承認しているなら本流で作業してもいい、 だめだったら LDP で作業するつもり。 で、画像形式がどっちがいいかはよくわからない。(佐野さん)
  
  その他、画像じゃなくてテキストリンクがいいとか諸々。

581366212

• ML の多数意見は一緒にするほうだったけど (Kjeldgaard)
• 紛らわしい名前があるのだが (Aznar)
• HOWTO は subject 別に分けるべきだろう. その際 カテゴリに "master" な HOWTO と mini があるのは 個人的にはいいことだと思うが (Lawyer)

It's simple to make tables in sgml-tools (linuxdoc).  One just uses a
<verb> environment with fixed width font (either use <tt> or
<tscreen>).  The result is a table in plain text just like one would
type on an old typewriter.  It isn't fancy but it serves the purpose.
It also displays OK in html, etc. (but html doesn't classify it as a
table although it actually is).

`-- Linux
    `-- docs
        |-- DOCBOOK (for docbook-only documents, each will have its subdir)
        |-- FAQ (for txt and html documents)
        |-- GUIDES (for other documents)
        `-- HOWTO
            |-- source
            |      |-- linuxdoc
            |      `-- docbook
            |-- dvi
            |-- html
            |-- info
            |-- pdf
            |-- ps
            `-- txt

 I agree with having a directory for each DocBook HOWTO, but not
 because it can't be converted to txt. The tag I'm suggesting at the
 HOWTO is like this:

<figure id="example-to-ldp">
   <mediaobject>
      <imageobject>
         <imagedata fileref="images/arquivo.eps" format="eps">
      </imageobject>
      <imageobject>
         <imagedata fileref="images/arquivo.jpg" format="jpg">
      </imageobject>
      <textobject>
         <phrase>Aqui h 癜ma imagem de exemplo</phrase>
      </textobject>
      <caption><para>Descri艫o da imagem. Opcional.</para></caption>
   </mediaobject>
</figure>

Why this structure? It is processed like this:

- Does the format of the output allow us to use eps graphics?
  |
  +- Yes. Use it. Show caption. End.
  |
  +- No.
      |
      +- Does it allow us to use JPEG graphics?
      |
      +- Yes. Use it. Show caption. End.
      |
      +- No.
         |
         +- Use text. Show caption. End.

• pdf は Linux への移行を考えている Win などのユーザに必要。 ps はなくてもいいのでは？ (Godoy)
• ps は "lpr file.ps" できるから欲しい。 pdf を置くことには反対しない (Zawodny)

• レイアウトを記述した文書が欲しい (Gjoen)
• linuxdoc-sgml → DocBook への変換はいまいちな部分がある。 とりあえず著者に確認してもらう必要があるかも。(Leblanc)

what stopped me in the road to docbook was two things:
*I could never compile sgmltools 2.0 and never know why and there was no
binary available at this time (may be a year ago)
*I was unshure if lyx could support both linuxdoc and docbook and I have
too many linuxdoc document to rewrite them.

 - announcement text
 - intro.ldp manpage source
 - disk.ldp  - sample man page stub for the Multi Disk HOWTO

This is sorting laziness, I think. The old "strcmp() is one lineof
code" stuff.

Please use "sort -f", the request is a sensible one, in my opinion.

• CVS 使って著者に勝手に文書を update してもらい、 変換などは自動でやるといいんではなかろうか？
• mini を統合するなら、統合後しばらくも現在の場所にコピーを残しておくべき。

Some LDP document such as "Programming-Languages-mini-HOWTO" uses
the <table>/<tabular> like:

<p>
<table>
<tabular ca="llllll">
Library|Beginner|License|Language|Bindings
|Examples|Comments @

TK|
        Yes|
        Free|
        TCL|
        PERL, Python, others|
        make xconfig, TKDesk|
        @

(snip)

(ftp://ftp.gmd.de/GMD/sgml/sgml2latex-format.1.4.tar.gz)

I'm logged on irc-2.mit.edu on #linuxdoc if you need to chat.
I would like to discuss the new format, the CVS and the announces.

Guylhem

• -f オプションを使えばいい (Godoy)
• そのように直す (Aznar)

• ML の Reply-To: フィールドの設定のせい。 procmail 使って、 ~/.procmailrc に以下のような 2 行を入れても解決する (Gutschke)

  :0 Wh: ~/.procmail/msgid.lock
  | formail -D 8192 ~/.procmail/msgid.cache
  

• ML の配信は遅いので、個人に同時に出すことも良く行われる。 が、私は今後はやめます (Godoy)
• オープンな ML なので、投稿者が subscribe してるか わからないから、両方に応えるのが私は好きだ (Rubini)

FC260E

11万円, 10% 引き。精度フルスケールの 2%。 バルブ normally open。 応答 6s。

FC260J

24万円、値引き後だいたい 20万円。精度フルスケールの 1%。 バルブ normally open。 応答 6s。

FC-770A

24万円、値引き後だいたい 20万円。精度フルスケールの 1%。 バルブ normally open。 応答 2s。

FC-770AC

FC-770A と同じで normally close。

I've visited the website and it looks wonderful, but I found it a bit
confusing. IMHO the "authors" section could be more task-oriented,
like:

* Authors
  - License (info on the recommended license(s))
  - Format (info on docs' format and ptrs to tools)
  - Style (notes on style)
  - Submission (a *page* on submission with info on submission format
    etc, rather than a simple mailto:// URI)

I think such a structure would be more logical.

Finally, I've been self-translating my HOWTOs to french for some time,
and finally lost the time/taste to do it. Are there tools that make
incremental translation easy? Maybe a set of scripts over CVS?
Is it intended to integrate such tools in the normal LDP development process?

Perhaps it is now time we finally abandoned the incredibly confusing habit
of referring to whatever SGML DTD we currently happen to be using, as simply
"sgml" -- and use more informative terminology such as "sgml-linuxdoc" and
"sgml-DocBook" to allow writers (and in particular, new authors) to gauge
correctly what DTD tagset they're going to be confronted with.

IMO, names such as "LinuxDoctools" and "DocBooktools" make much more sense
than sgmltools v.1, 2, etc., especially to those of us already used to using
TEItools et al., and juggling with a large catalog(sic) of DTDs to feed to
emacs or whichever other SGML-aware editor we're using.

BTW I'm going to Italy until next monday, but Joshua, Greg and Paul have
my cellular phone number if something went very wrong. (???)

• 到着した ORA の DocBook 本見て勉強してる。 来週くらいには CVS と DocBook に関する文書を出したい。 (Mark Komarinski)
• (http://metalab.unc.edu/godoy/)
  に DocBook の情報がある。 文書の submit は submit ML の方にしてほしい。(Leblanc)

• 目次の生成法は？ LinuxDoc の <toc> に対応する出力が DocBook にはされないようだ。
• sgmltools -b html によって出来るファイル名 (t1.html, x23.html...) というのはいいのだろうか？これは変更できる？
• revision history や legal notice 等は、どのように扱われる？ DocBook にはこれら用のタグがあるのだが。

• 目次については "customization" が必要。 HOWTO に書く。
• <sect[12345]> のあとに <?dbhtml filename="file_name.html"> 等を置けばよい。あるいは customization でも可能。
• 処理する customization をするつもり。

• PROPRIETARY という大きな欠点がある (Hugo)
• 使っている技術自体はすべて open だ。移植は可能だろう。 ちなみに Screen shot をおいたので見てみてほしい。(Gjoen)
• (http://home.netscape.com/eng/help/details/details.htm)
  をみると、ちょっと慎重になる必要がありそうだが (Ferguson)
• 代替品を作ることに問題はないと思うが (Gjoen)

• 著作権などを消しているなら問題だ。 ISP に連絡すべきでは。 (Yves Bellefeuille)
  
  slashdot はそうしてるようだ (Poet)
  
  
• ここのメンバーの多数からメールを送ってプレッシャーをかけるのはどうか。 (Tom Fawcett)

• でもわかりにくくならないか (Raul Miller)
  
  
• オプションの幅によるが、誤謬を招きやすいと思う (rms)
  
  同意。 OSI 問い合わせが増えたり、あまりいいことはないと思う (G. Branden Robinson)