c++ - library - descargar boost
¿Una referencia de Better Boost? (4)
Lo que realmente me decepciona de Boost es su documentación. Lo que necesito es una buena referencia, y en lugar de explicar lo que es una buena referencia para mí, daría un ejemplo:
java.sun.com/javase/6/docs/api/ Sí, me encanta. También es esto: cppreference.com/wiki/stl/vector/start
Por otro lado, lo que encuentro sobre el impulso es algo como esto: http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm
Básicamente, una larga página de texto. Casi ningún formato, texto en negrita aquí y allá y con suerte algunos enlaces entre elementos. Sin mencionar que smart_ptr es una de las bibliotecas mejor documentadas.
Si no encuentra la diferencia entre este y los ejemplos anteriores, detenga la lectura e ignore esta publicación. No me malinterpretes, escribo C ++ y uso Boost. En mi empresa usamos al menos 4 de sus bibliotecas, y cada vez que necesito verificar un prototipo de método, por ejemplo, me saca de mis nervios el desplazamiento a través de sus ensayos. Y sí, sé que Boost es un proyecto colaborativo y que diferentes bibliotecas desarrollan diferentes bibliotecas.
Entonces, ¿alguno de ustedes comparte mi decepción con la referencia de Boost y conoce algún sitio mejor documentando las bibliotecas de Boost?
Definitivamente estoy de acuerdo. Javadoc es desagradable, desagradable. Pero es minucioso y constante en casi todos los proyectos. Compare la capacidad de navegación de una documentación aleatoria del proyecto de Yakarta con la de un proyecto aleatorio de Boost.
En general, no encuentro la documentación tan mala. En general, nuevamente, la información está "en algún lugar" allí. El problema principal que veo es la falta de uniformidad, lo que dificulta encontrar ese "lugar". Al escribir en su pregunta, los documentos fueron escritos por diferentes personas, y en diferentes momentos, y esa es probablemente la causa de esta falta de una estructura común.
De los enlaces java y cppreference que cita en el ejemplo, deduzco que está más interesado en la sinopsis de la interfaz que en cosas "tutoriales" o de "motivación". Para shared_ptr, ¿proporciona http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm#Synopsis lo que buscas?
Para algunas bibliotecas, los directorios "test" y "example" en libs/<library_name> son útiles.
Puede publicar sus preguntas, comentarios y sugerencias sobre los users impulsores y / o listas de correo de documentation . Según lo que veo allí, los encargados de mantenimiento de la biblioteca suelen dar la bienvenida a las sugerencias específicas de mejora de la documentación.
Mirando el enlace de Java proporcionado, más de la mitad está obsoleto desde hace bastante tiempo :)
Ahora tiene herramientas PDF y formato PDF de los documentos. Hay herramientas y más en su camino, desde el libro de ayuda para escritores de lib a la sinopsis y más. Construya su propia cuenta o analice la mayoría de los costos de marcado hasta un proyecto ya exagerado :)
Si está buscando un texto introductorio, encontré el libro de Bjorn Karlsson muy bueno. Hace un tiempo, cuando lo leí, puede haber textos más actualizados disponibles ahora. Encuéntralo aquí .