¿Apple proporciona un sitio web con contenido de páginas 'man' para los comandos de línea de comandos incluidos con Mac OS X?

14

Deseo proporcionar enlaces URL al contenido de la página de manual en apple.com como una fuente autorizada de información. Describir y citar la página de manual local es incómodo.

¿Apple proporciona páginas de manual en la web?

command-line documentation Albahaca Bourque
fuente
Cada versión de OS X ya contiene copias locales de páginas de manual para programas de línea de comandos, por lo que no hay necesidad de apuntar a otra parte y por qué Apple ya no mantiene un conjunto de páginas para cada versión en su sitio web.
user3439894
44
Es útil tenerlos en un sitio web para vincular a programadores que usan otros sistemas operativos. También una compañía del tamaño de Apple podría tenerlos en su sitio básicamente sin ningún esfuerzo.
Lassi
Los necesito todo el tiempo. A veces intento escribir scripts de shell que admitan tanto Linux como macOS (solo por ejemplo, si readlinkestá disponible en Mac o cómo obtener el tamaño del archivo en bytes stat). Claro, podría ir a buscar las páginas del manual de BSD, pero vamos , Apple.
TheDudeAbides el

Respuestas:

4

El antiguo índice en línea parece haber desaparecido. Sin embargo, puede encontrar el código fuente de las páginas del manual en https://opensource.apple.com/ . Este sitio también alberga versiones históricas.

Por ejemplo:

Desafortunadamente, no hay una descripción general de todas las páginas del manual, por lo que debe verificar manualmente los índices de directorio o usar algo como site:opensource.apple.com/source "ls.1"en DuckDuckGo o Google.

Lekensteyn
fuente
El site:opensource.apple.com/sourcetruco es brillante. Para obtener una lista explorable de todas las páginas del manual de todas las secciones del manual (aunque datan de OS X 10.9 días), vea mi respuesta a continuación.
TheDudeAbides
3

Sí, Apple proporciona estas páginas en línea, por ejemplo: https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man1/ls.1.html para el comando ls .

Fuente: Dr. Drang

samh
fuente
77
Ese enlace contiene la palabra "heredado" y se dirige a la versión anterior de Mac OS X. No pude encontrar ediciones actualizadas de ese sitio.
Basil Bourque
3
No sé qué podría estar desactualizado, ese es el problema. Las páginas dicen claramente en letra grande en la parte superior This manual page is for Mac OS X version 10.9. La barra superior de la página dice "Biblioteca de documentos retirados". Y el "legado" en la industria de TI definitivamente es un eufemismo de "obsoleto, ya no recomendado o aplicable". Entonces, si bien este sitio puede ser mejor que nada, ciertamente no es bueno para las discusiones actuales. Agradezco su publicación, solo desearía que hubiera ediciones actualizadas y de versiones específicas de las páginas man en la web.
Basil Bourque
99
@samh Hola, esta URL está muerta ahora
SebMa
10
Parece que Apple eliminó esa sección de su sitio ... ¿alguna nueva ubicación?
0xF2
1
@ 0xF2 Puede acceder a versiones antiguas en archive.org, pero Apple dejó de actualizarlas en OS X 10.9.
Zenexer
3

¡Hola desde el mundo futuro de 2019!

Lamentablemente, parece que una búsqueda en la web site:opensource.apple.com/source stat.1sigue siendo el estado fundamental de las cosas, si desea documentación "oficial" de apple.com.

Aquí hay algunas alternativas:

  • Páginas del manual de Darwin sobre la máquina Wayback
    • Esta es una captura de mayo de 2018, para OS X 10.9 (Mavericks), y todavía hay algunos agujeros, por lo que es posible que deba retroceder más en el tiempo con Wayback Machine para obtener algunas de las páginas.
  • Páginas de manual de Mojave (10.14) en unix.com
    • el diseño del sitio aquí utiliza un ex cru cantidad ciating de espacios en blanco, y es probable que necesita para hacer un zoom hacia fuera para ver las páginas de manual en su totalidad

Actualización: Por cierto, puede formatear la fuente roff sin formato de las páginas man en opensource.apple.com en algo legible para humanos como este:

  1. copie la URL de "texto plano":

    ingrese la descripción de la imagen aquí

  2. buscar esa URL curly formatearla para verla en pantalla con groff:

    # use 'wget -qO -' if you don't have 'curl'
curl -s https://opensource.apple.com/source/grep/grep-28/grep/doc/grep.1 \
  | groff -man -T utf8 \
  | less

    Algunas notas al margen sobre ese groffcomando:

    • agregue -rLL=${COLUMNS}npara usar todo el ancho de su terminal, si 80 columnas no lo hacen por usted; el mancomando generalmente hace algo de magia para autodetectar esto del tamaño de su terminal ( referencia )
    • puede sustituir groff -man -T ps > ~/Desktop/grep.1.psesa última parte para obtener una hermosa página de manual PostScript que puede abrir e imprimir con Preview.app, si eso es lo suyo
El tipo respeta
fuente
básicamente "Hola del mundo futuro" es correcto para cada respuesta dada que hay.
Max Ried el
Si el mundo futuro realmente solucionó su problema y se molestó en informar. Pero a veces el mundo futuro simplemente bloquea tu hilo, sin resolución para nadie . :/
TheDudeAbides
2

Hay algunas páginas MacOS hombre aquí , aunque no sé cómo completa la lista es.

benwiggy
fuente
SS64 es un recurso realmente bueno para cualquiera que trabaje en un entorno de línea de comandos, en cualquier sistema operativo. Está bien estructurado, completo y ordenado. Si solo la documentación oficial de Microsoft (o Apple) estuviera a la altura de este estándar .
TheDudeAbides