RFC118 日本語訳

Network Working Group                                     Richard Watson
Request for Comments: 118              Stanford Research Institute (ARC)
NIC: 5830                                                  16 April 1971

コメントを求めるワーキンググループリチャードワトソンRequestをネットワークでつないでください: 118 スタンフォード研究所(アーク)NIC: 5830 1971年4月16日

                RECOMMENDATIONS FOR FACILITY DOCUMENTATION

施設ドキュメンテーションのための推薦

INFORMATION REQUIRED FOR EACH SERVICE AVAILABLE TO THE NETWORK

情報がネットワークに利用可能なそれぞれのサービスに必要です。

   There are two classes of information which a site needs to provide
   for each service or process it makes available over the Network:

サイトがそれがNetworkの上で利用可能にする各サービスかプロセスに備える必要がある2つの情報の種類があります:

      i) information required by system programmers in order to
      establish a connection to the facility

i)情報が、システム・プログラマが、施設に取引関係を築くのに必要です。

      ii) information required by a user to gain access to and use the
      facility

ii)情報はアクセスを得るユーザと使用による施設を必要としました。

   The above two basic kinds of information which need to be in each
   facility description will comprise a "functional document" (see RFC
   115, NIC (5822,) for a description of functional documents and
   recommended procedures for updating them).

それぞれの施設記述にはある必要がある上の基本的な2種類の情報が「機能的なドキュメント」(それらをアップデートするための機能的なドキュメントとお勧めの手順の記述に関してRFC115、NIC(5822)を見る)を包括するでしょう。

   The information required by user site system programmers may be a
   detailed document or a reference to a document containing a protocol
   common to several facilities or some combination of the above.  All
   information required such as connection socket numbers, message
   formats, and character set information must be included.  Two
   examples of system programmer type information are RFC 74, NIC
   (5417,) and RFC 105, NIC (5775,) prepared by James White of UCSB.

ユーザの現場システム・プログラマによって必要とされた情報は、いくつかの施設に共通のプロトコルか上記の何らかの組み合わせを含むドキュメントの詳細なドキュメントか参照であるかもしれません。 接続ソケット番号や、メッセージ・フォーマットや、文字集合情報などのように必要であるすべての情報を含まなければなりません。 システム・プログラマタイプ情報に関する2つの例が、RFC74と、NIC(5417)とRFC105です(UCSBのジェームス・ホワイトによって準備された(5775)NIC)。

   The information required by user site users is of three types:

3つのタイプにはユーザの現場ユーザによって必要とされた情報があります:

      a) information unique to Network users of the facility

a) 施設のNetworkユーザにユニークな情報

      b) information in common between Network users and server site
      users of the facility

施設のNetworkユーザとサーバサイトユーザの間で一般的のb)情報

      c) information unique to particular Network user site.

特定のNetworkユーザの現場にユニークなc)情報。

   The information of type c) would be prepared by the user site from
   the information provided by the server site.  An example might be
   keying conventions required in order to send certain codes to the
   server site.

タイプc)の情報はサーバサイトによって提供された情報からのユーザの現場によって準備されるでしょう。 例はあるコードをサーバサイトに送るのに必要であるコンベンションを合わせているかもしれません。

Watson                                                          [Page 1]

RFC 118        Recommendations for Facility Documentation     April 1971

施設ドキュメンテーション1971年4月のためのワトソン[1ページ]RFC118推薦

   Future documentation will probably be written with information types
   a) and b) above integrated in one document, but initially server
   sites will probably have user manuals or documentation for their
   local users and will need to write a short document giving any
   additional information required for Network users.  This information
   will vary, but might include a different login or control card
   sequence, varying echo or syntax for user sites operating with
   character at a time, line at a time, server site or user site echoing
   and so forth.  Some features available to server site users may not
   be available to Network user site users or certain features may
   behave differently.

将来のドキュメンテーションがたぶん上に情報タイプa)とb)で1通のドキュメントで統合していた状態で書かれますが、初めは、サーバサイトは、たぶん地元のユーザのための利用者マニュアルかドキュメンテーションを持って、Networkユーザに必要である追加情報を与えながら短いドキュメントを書く必要があるでしょう。 時(時間かサーバサイトかユーザの現場反響などにおける系列)にキャラクタと共に作動するユーザの現場への異なった異なったログイン、制御カード系列、エコーまたは構文を含むかもしれないのを除いて、この情報は異なるでしょう。 サーバサイトユーザにとって、利用可能ないくつかの特徴は、Networkユーザの現場ユーザにとって利用可能であるか、または特徴が異なって振る舞うかもしれないのを確信していないかもしれません。

   In addition to the above types of information, there should be
   instructions to the user on how to obtain help or answers to
   questions about using the facility.

上のタイプの情報に加えて、ユーザへのどう助けを得るかに関する指示か施設を使用することに関する質問の答えがあるべきです。

   Information about how to obtain administrative access (charge
   numbers, etc.) to a site should be contained in the document, ARPA
   Network Current Guides to Network Facilities, NIC (5148,).  This
   information is being collected by BBN.  This document will in turn
   contain references to the functional documents containing detailed
   descriptions of available Network facilities and how to use them.

どう、サイトへの管理アクセス(電荷数など)を得るかに関する情報はドキュメントに含まれるべきです、Network FacilitiesへのアーパネットCurrentガイド、NIC(5148)。 この情報はBBNによって集められています。 このドキュメントは順番に利用可能なNetwork施設とどうそれらを使用するかに関する詳述を含む機能的なドキュメントの参照を含むでしょう。

   Even if there are no special conventions or information unique to a
   Network user as opposed to a server site user, this fact should be
   explicitly stated in order to avoid confusion or uncertainty.

サーバサイトユーザと対照的にNetworkユーザにユニークなどんな特別なコンベンションも情報もなくても、この事実は、混乱か不確実性を避けるために明らかに述べられるべきです。

NETWORK INFORMATION CENTER POLICY ON DISTRIBUTION AND UPDATING OF
   DOCUMENTATION

ドキュメンテーションの分配とアップデートに関するネットワーク情報センター方針

   The Network Information Center will distribute and maintain one copy
   of each functional document describing a facility in each Network
   Station NIC Collection.  For this purpose we would appreciate it if
   100 copies of each manual and set of manual updates, when they occur,
   could be sent to the NIC.  Users at sites desiring their own copies
   of user documentation can obtain them either directly from the server
   site or by copying the master in their local NIC Collection.  In
   order that users may know where to obtain additional copies of the
   documentation, an address and a price, if any, should be included in
   the information about each facility.

Networkインフォメーション・センターは、それぞれのNetwork駅のNIC Collectionで施設について説明するそれぞれの機能的なドキュメントのコピー1部を分配して、維持するでしょう。 起こるとき、コピー100部のそれぞれのマニュアルとセットの手動のアップデートをNICに送ることができれば、このために感謝致します。 サイトのそれら自身のユーザドキュメンテーションのコピーを望んでいるユーザは、直接サーバサイトか地元のNIC Collectionにマスターをコピーすることによって、それらを得ることができます。 ユーザが、どこでドキュメンテーションの複本を得るかを知ることができるように、もしあればアドレスと価格は各施設の情報に含まれるべきです。

        [ This RFC was put into machine readable form for entry ]
        [ into the online RFC archives by Mirsad Todorovac 10/98 ]

[このRFCはエントリーのためのマシンに入れられた読み込み可能なフォームでした][Mirsad Todorovac10/98によるオンラインRFCアーカイブへの]

Watson                                                          [Page 2]

ワトソン[2ページ]