From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mail-yw0-f175.google.com ([209.85.161.175]) by ewsd; Sat Mar 17 22:34:00 EDT 2018
Received: by mail-yw0-f175.google.com with SMTP id r66so9461406ywh.10
        for <9front@9front.org>; Sat, 17 Mar 2018 19:33:56 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20161025;
        h=mime-version:in-reply-to:references:from:date:message-id:subject:to;
        bh=iAk33+RNyY9ZrM1hS6/uMSWjVJP/1jYCngze2Ie8i2E=;
        b=MO9CyPppsW7vrwmJ1N3Csw+scQ1MYAvjaSkNXkWjeOfKmoKGtBojlOBXVz/COUak2E
         ty+8ij+AVPom2KLqs7F2f9ic6MBVviS9HMXDG25FJ0Mw1kG/zQ2uoCGRZkZtBMLWB2t2
         aaA/s7QY6xJxaczNYINKOgkysQqeTAkfRAytpMcuPlO4IEuDSGfwwIvvdhgicrxasZMi
         xZULpsWLeH4T0wLg3r0Ddwkl/+27/ngUYvMLgOGMI9nfXRvpSGd5tJNlrG2jHetue0Sd
         18q1T6heIyNB5bYMSiieTYSn2/DGvgm4/SvZLIv6XvfZwcAaOuZdlUAy1q9op/iw2Msl
         mg0Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20161025;
        h=x-gm-message-state:mime-version:in-reply-to:references:from:date
         :message-id:subject:to;
        bh=iAk33+RNyY9ZrM1hS6/uMSWjVJP/1jYCngze2Ie8i2E=;
        b=PHNeODrgGD625wymxhRMJbtTI66hzym5WXBrbOEtonGW0EIkauunCGVU4bEsMfH7Xb
         wBq0r5AcCZn0PW7sk99bXFYU+S+C/S0WbkGyxtgpCpHOzBBgnNV9TNWtwYMDoNYxcpzZ
         GmdF3Frng6BZaALWuyc9YQjoRYGN1jW5gzNUmmxmYMUc7SeyHH3J1pTh7+WIisi94ewo
         A/Ud14MeLPyi/aIuWfBwvbxrs2ehkW6ORgLPfg6tu9qXyrLNbCZeYAfvkDj1J9u/yM26
         CncLC7wE1iyo/w/0qL8Bu+fKnuXN18DDPfHBqLcyigN3GO9Sf+KUOvGdsa0uDhTiFmBf
         8I9w==
X-Gm-Message-State: AElRT7HLm5/xG4dl8af2fXaFCN95PMvvtgxtdqlQomx2ZI4J2FgJCzPn
	DsEu8vky13j0LZpjWcacz1KDZkaWVg1cMWxQEJk=
X-Google-Smtp-Source: AG47ELtaQ4Bz7VPvnp/ETz9R5AG1PLkqmwiyaxwFjOy9agms/nn4yp2vz6UFS+llBpHntvcVimMC35qLtZKx5Ehy4ys=
X-Received: by 10.129.39.196 with SMTP id n187mr1393210ywn.435.1521340435412;
 Sat, 17 Mar 2018 19:33:55 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.129.48.8 with HTTP; Sat, 17 Mar 2018 19:33:54 -0700 (PDT)
In-Reply-To: <alpine.BSF.2.21.1803171411240.47626@orthanc.ca>
References: <5727ED416549AF09B9CA5BAFD544869E@5ess.inri.net>
 <alpine.BSF.2.21.1803151827200.47626@orthanc.ca> <CAFSF3XNithnfU15FeVD-BXcBosbZsAgDrWKkHTOSYRD_R0x28g@mail.gmail.com>
 <CFBDD24F-53EE-4093-84E9-D979FF51F1CF@stanleylieber.com> <CAFSF3XOBnpAZ2TrZOY1r7+XxAP05L5D6QfEJbiSES80YfptObw@mail.gmail.com>
 <alpine.BSF.2.21.1803171411240.47626@orthanc.ca>
From: hiro <23hiro@gmail.com>
Date: Sun, 18 Mar 2018 03:33:54 +0100
Message-ID: <CAFSF3XO4P+k0ZFyc7xFVaZRE2q+HDUcNCsmoUw+a=Tv=OwsssA@mail.gmail.com>
Subject: Re: [9front] Argument lists in Plan 9 man pages
To: 9front@9front.org
Content-Type: text/plain; charset="UTF-8"
List-ID: <9front.9front.org>
List-Help: <http://lists.9front.org>
X-Glyph: ➈
X-Bullshit: managed asynchronous pipelining singleton general-purpose table 

neither are tutorials, but i would always recommend reading both to
get a good overview.

also: man pages are updated, /sys/doc stuff often is outdated.

earlier sl was correct to complain. what i really wanted to point out
is the significance of this additional use case, i.e. man pages cover
both a lot of detail (for quick references) and more abstract
overview.

On 3/17/18, Lyndon Nerenberg <lyndon@orthanc.ca> wrote:
>> They are meant to be read also for getting an overview of the system.
>
> I think /sys/doc/* fulfills that role.
>
> Which isn't to say you can't learn a lot from reading manpages, but they
> aren't tutorials.
>