Slashdot Mirror


Apple Launches Reference Library

andy55 writes "If you thought Apple's online dev resources were already the best out there, they just got better. Apple has announced the launch of their new ADC Reference Library. Named features are: powerful search options, added navigation, 'Getting Started; docs on key technologies, and a more consistent organization. Impressively, the first search I ran in their search engine on a painful Mach-O dev issue I've been fighting for the last week turned up the key obscure tech info I needed!" Meanwhile, skrysakj writes "Apple has launched a new Reference Library. I always thought their help/references for Developers was spotty (either non-existent or dead on) so this should be a welcome change."

11 of 46 comments (clear)

  1. Great stuff by tiktokfx · · Score: 5, Informative

    However, in reference to the "spotty references" on developing... there's plenty of reference material for those who look... nice heavy folder full of documentation in the developer tools installation.

  2. Paranoid by Anonymous Coward · · Score: 5, Interesting

    Even though I have no prior reason for distrusting Apple, I get the feeling that eventually this information will be accessible to developers paying a premium rather than those of us who signed up for the free account.

    Anyone know if the ADC is going to replace the current /Developer/Documentation that comes with OSX? 6 years ago I used to sit and while away the hours reading man pages and HOWTOs in Linux, and since I bought a PowerBook I find I'm doing the same kind of thing with their docs which I have locally installed. The ADC (that's Apple Developer Connection, not the monitor connector ;) looks awesome, but a local, offline copy would be even better.

    I guess I could always buy a printer...

    1. Re:Paranoid by the_proton · · Score: 5, Informative

      The local offline copy should be part of the next Xcode release. The documentation that comes with Xcode is just a snapshot of what was on the various areas of the ADC site as the software was released.

      - proton

    2. Re:Paranoid by jwthompson2 · · Score: 5, Insightful

      I think your paranoia is somewhat interesting but the current model that Apple has with distributing XCode and other development resources freely with their operating system is the most valuable model. Heck, MS is talking about have command line development tools available in the default install of Longhorn. The concept of 'every user a developer' is something Apple is and will continue to benefit from if they maintain their current stance.

      --
      Even if I knew that tomorrow the world would go to pieces, I would still plant my apple tree. -Martin Luther
    3. Re:Paranoid by Etcetera · · Score: 5, Insightful

      every user a developer

      Oh please. Who exactly will benefit, and how?


      Go read up on the history of HyperCard, yo. Plenty of people benefited from the use of it, and many are still benefiting today.

    4. Re:Paranoid by Graff · · Score: 5, Insightful
      Even though I have no prior reason for distrusting Apple, I get the feeling that eventually this information will be accessible to developers paying a premium rather than those of us who signed up for the free account.

      Actually, if anything Apple has gotten more free with its documentation. It used to be that Apple sold huge tomes called "Inside Macintosh" which described the inner workings and APIs of the Mac. There were at least 2 dozen of these books which covered every inch of programming on a Mac, gathered by topic. Each of these books would run $35 or so. You didn't need every one of them but it really helped to have about a half dozen of the key ones, so figure about $35 * 6 = around $200.

      As Apple entered its current Mac OS X stage it began to take on more and more of a open-source flavor. Documentation was being distributed along with free programming tools, prices were dropping to become a registered developer, a free type of registered developer appeared, code was being released back to the community with minimal licenses, etc.

      Right now it is the best time to be an Apple developer. It literally costs you nothing to become an official registered developer. If you do pay for one of the higher levels of being a registered developer you get significant price breaks and free stuff which pays many timed over for the price of registering. Students can pay a pittance of $100 and they get way over $500 in benefits. Apple staff is very responsive on their mailing lists and there are a ton of new developers out there who share your enthusiasm and who are willing to help.

      As a worst case, even if Apple does change its policy (not likely because they WANT people to program for the Mac) and starts charging for programming documentation it is unlikely that the free programming information out there will disappear. That's because EVERY version of Mac OS sold in the last few years includes this free documentation. There's no way that Apple will change its APIs fast enough to make that documentation obsolete for at least a decade. Yeah a command here or there might get depreciated but Apple takes their time in truly tossing anything out. You will be fairly safe using old, free documentation that you can get freely off a Mac OS X cd from a few years past.
    5. Re:Paranoid by jamesbrown1000 · · Score: 5, Insightful

      I agree wholeheartedly.

      I started a new job in January and my supervisor is a big AppleScript guy. From that, I've started learning AppleScript Studio in Xcode. There isn't much I can't do with AppleScript and shell scripts, and that's led me to write my own little apps in the past month or so.

      Every user has the power to make his own software. How cool is that?

      --
      Mindy: "Well...desserts aren't always right." Homer: "But they're so sweet!"
    6. Re:Paranoid by Jeff+Kelly · · Score: 5, Insightful

      "Oh please. Who exactly will benefit, and how?"

      Every user which develops applications is a good thing. Talent is only 20% of art. The other 80% come from experience and practice. Nobody is a born coder. Some of the greatest developers in the industry started their career with such development tools. And it took them years of coding to get them where they are today.

      Every new application is an argument for using that particular platform even if it is only a mediocre program.

      A Linus Torvalds had 12 years working on the linux kernel-code to take him from an apprentice student programmer to the wizkid he is today.

      Without gcc and similar free development tools we would never have had something like the current BSDs, Linux, Apache, Gnome, KDE you name it.

      Even Microsoft releases the basic development tools for free. (Platform SDK)

      This benefits everybody. Without free development tools we would have to pay premium for even the simplest programs and would be very limited in choice because only those who could afford the $1500 Visual Studio or the $3000 IBM Tools could develop applications.

      "It is sad that programming is becoming yet another wannabe art and is rather ceasing to be an art altogether."

      Elitist bullshit. Even Dali or Picasso had to do mundane tasks to earn their living and it took them decades to perfect their art.

      Art lies in the eye of the beholder. The more people are practicing it the more will come out of it. The beginners can learn from the professionals (reading code for example) and the professionals have enough competition so that they are not likely to grow content with what they have accomplished already.

      This is what is driving on every art form. Those who would like to limit it are the ones who fear to lose their renown, fame or status.

      p.s. i apologise in advance for the spelling and grammar mistakes i am not a native speaker.

  3. Definitely a step in the right direction... by Chief+Typist · · Score: 5, Informative

    The newly release Reference Library is very well organized and makes finding things much easier. Good job, Apple! It's been a long time coming!

    There's still a problem, though. Much of the "state of the art" documentation is actually happening on the Mac OS X and Cocoa mailing lists. It's good to have reference materials, but if you're looking for information on the latest & greatest addition to the OS, go search the archives.

    You'll find that you can get answers directly from the developers before the reference materials are formalized and made public. As an example, in the months following last year's WWDC, there was a ton of information on the lists about the new Cocoa Bindings. As a developer who wants to stay on the leading edge of Mac OS X product development, this is invaluable.

    Also, the guy that is running the mailing list archive, is looking for donations. If you are a developer who uses these archives, PLEASE DONATE.

    -ch

    1. Re:Definitely a step in the right direction... by bar-agent · · Score: 5, Informative

      Another good source of information is the cocoadev.com wiki. Documentation gaps are filled pretty quickly -- I should know, I'm a regular contributor.

      --
      i'd hit it so hard, if you pulled me out you'd be the king of britain [bash.org]
  4. Re:good for beginners by Anonymous Coward · · Score: 5, Informative
    Oh, and I don't want to hear anyone try to compare Windows' cmd.exe with a bash shell.

    Too bad :P I like cmd.exe and use it every day. Some features it has that give it some respectability:

    • Redirection operators < > |
    • Logical operators && ||
    • Macros somewhat similar to bash's. Try doskey macro_name=command_line
    • Ability to redirect stderr to stdout Try 2>1 or 1<&2
    • User-defined file descriptors (or in Windows-speak, handles). >&3 >&4 and so on up to 9
    • improved looping. for /l %a in (start,step,end) do for_body for iterative loops.
    • better text file parsing. Try for /f. You can read in a text file, break it up into tokens and pass the tokens to a command. You can also do that with command output or strings.
    • Tab completion
    • /dev/null workalike. Redirect to NUL instead.
    • directory stacks. pushd and popd
    • Ability to read in input and store it into a variable. set /p variable=promptString
    • Advanced arithmetic. set /a can do modulus, bitshifts, bit flipping, compound assignment, xor, bitwise or, bitwise and
    • improved decision selection. if string operator string body The operator can be equ for equal, gtr for greater than, and so on.
    • grep replacement, findstr. Has the ability to use regular expressions.
    Anyway, cmd.exe is not as crippled as command.com. It is much more capable and useful. It can even somewhat hold its own against Unix shells.