• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: on the lack of documentation (was: Re: on neophytes vs perfectionists)
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: on the lack of documentation (was: Re: on neophytes vs perfectionists)


  • Subject: Re: on the lack of documentation (was: Re: on neophytes vs perfectionists)
  • From: Shane Stanley <email@hidden>
  • Date: Sat, 20 Dec 2008 17:18:45 +1100
  • Thread-topic: on the lack of documentation (was: Re: on neophytes vs perfectionists)

On 20/12/08 2:27 PM, "Mark J. Reed" <email@hidden> wrote:

> Man pages vary greatly in quality, but just about all of them have all
> the information you need, even if its hard to find.

Perhaps not so much hard to find as hard to fathom without some background
in shell scripting. I'm not saying they're worse than AS dictionaries, just
that they're not something I'd hold up as a shining example. I get the
impression that the aim of many is to be as terse as possible, often at the
expense of helpfulness.
>
> Most man pages include an EXAMPLES section, which alone goes a long way.

I have no idea about most, but a quick check of cp, mv, rm, ls doesn't turn
up an examples section between them.


--
Shane Stanley <email@hidden>
AppleScript Pro Florida, April 2009 <http://scriptingmatters.com/aspro>


 _______________________________________________
Do not post admin requests to the list. They will be ignored.
AppleScript-Users mailing list      (email@hidden)
Help/Unsubscribe/Update your Subscription:
Archives: http://lists.apple.com/archives/applescript-users

This email sent to email@hidden

  • Follow-Ups:
    • Re: on the lack of documentation (was: Re: on neophytes vs perfectionists)
      • From: "Mark J. Reed" <email@hidden>
References: 
 >Re: on the lack of documentation (was: Re: on neophytes vs perfectionists) (From: "Mark J. Reed" <email@hidden>)

  • Prev by Date: Re: on the lack of documentation (was: Re: on neophytes vs perfectionists)
  • Next by Date: Re: Tell Blocks Considered Harmful (was Re: open for access)
  • Previous by thread: Re: on the lack of documentation (was: Re: on neophytes vs perfectionists)
  • Next by thread: Re: on the lack of documentation (was: Re: on neophytes vs perfectionists)
  • Index(es):
    • Date
    • Thread