В общем, я не считаю документацию такой плохой. В общем, опять информация где-то там. Основная проблема, которую я вижу, заключается в отсутствии единообразия, что затрудняет поиск этого «где-то». Как вы пишете в своем вопросе, документы были написаны разными людьми, и в разное время, и это, вероятно, причина этого отсутствия общей структуры.
Из ссылок на java и cppreference, которые вы привели в качестве примера, я делаю вывод, что вы больше заинтересованы в кратком изложении интерфейса, чем в «учебном пособии» или «мотивации». Для shared_ptr http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm#Synopsis
обеспечивает то, что вы ищете?
Для некоторых библиотек полезны каталоги «test» и «example» в libs/
.
Вы можете оставлять свои вопросы, комментарии и предложения в списках рассылки пользователей и / или документации. Судя по тому, что я вижу, сопровождающие библиотеки обычно приветствуют конкретные предложения по улучшению документации.
Начиная с Mac OS X v10.6 (Snow Leopard), вы можете запускать Java 6 в 32-битном режиме на 32-битной или 64-битной ] Mac, оборудованные процессором Intel .
Если вы не можете выполнить обновление до Snow Leopard, Soy Latte представляет собой предварительно скомпилированную версию Java 6 для 32-разрядной версии Intel.
Как правило, вы не можете установить другие версии Java на Mac, чем те, которые были предоставлены Apple через Обновление программного обеспечения. Если вам нужна Java 6, у вас должен быть 64-битный компьютер Intel. У вас всегда должны быть установлены Java 5 и 1.4 и, возможно, 1.3, если у вас хотя бы OS X 10.4.
Если у вас ОЧЕНЬ много смазки и вы готовы работать с бета-версией программного обеспечения, вы можете установить OpenJDK под OS X, но я не думаю, что вы хотите туда идти.
As the message says, you have to go to Apple, not Sun, for Java on the Mac. As far as I know, Apple JDK 6 is installed by default on Mac OS X 10.6 (Snow Leopard). Maybe you need to install the developer tools from your Mac OS X installation DVD (the dev tools are an optional install from the OS DVD).
See: http://developer.apple.com/java/
NOTE This answer from 16 Oct 2009 is now outdated; you can get the JDK for Mac OS X from the regular JDK download page on Oracle's website now.
The explanation is that JDK is a bit specific and does not contain the library tools.jar. For my development, I need this library and Mac's JDK doesn't provide it:
tools.jar does not exist. Classes usually located here are instead included in classes.jar. Scripts that rely on the existence of tools.jar need to be rewritten accordingly.
It sucks!