A Apple fornece um site com conteúdo de páginas `man` para os comandos de linha de comando fornecidos com o Mac OS X?

14

Desejo fornecer links de URL para o conteúdo da página de manual em apple.com como uma fonte autorizada de informações. Descrever e citar a página de manual local é complicado.

A Apple fornece páginas de manual na web?

Basil Bourque
fonte
Cada versão do OS X já contém cópias locais de páginas de manual para programas de linha de comando; portanto, não há necessidade de apontar para outro lugar e por que a Apple não mantém mais um conjunto de páginas para cada versão em seu site.
User3439894
4
É útil tê-los em um site para vincular a programadores que usam outros sistemas operacionais. Além disso, uma empresa do tamanho da Apple poderia tê-los em seu site, basicamente, sem esforço.
Lassi
Eu preciso disso o tempo todo. Às vezes, estou tentando escrever scripts de shell que suportam Linux e macOS (por exemplo, se readlinkestá disponível no Mac ou como obter o tamanho do arquivo em bytes stat). Claro, eu poderia procurar nas páginas de manual do BSD, mas vamos lá , Apple.
TheDudeAbides 9/11/19

Respostas:

4

O antigo índice online parece ter desaparecido. No entanto, você pode encontrar o código fonte das páginas de manual em https://opensource.apple.com/ . Este site também hospeda versões históricas.

Por exemplo:

Infelizmente, não há uma visão geral de todas as páginas de manual, então você deve verificar manualmente os índices de diretório ou usar algo como site:opensource.apple.com/source "ls.1"no DuckDuckGo ou no Google.

Lekensteyn
fonte
O site:opensource.apple.com/sourcetruque é brilhante. Para obter uma lista navegável de todas as páginas de manual de todas as seções do manual (embora remonta ao OS X 10.9 dias), veja minha resposta abaixo.
TheDudeAbides 9/11/19
3

Sim, a Apple fornece essas páginas online, por exemplo: https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man1/ls.1.html para o comando ls .

Fonte: Dr. Drang

samh
fonte
7
Esse link contém a palavra "legado" e aborda a versão antiga do Mac OS X. Não foi possível encontrar edições atualizadas desse site.
Basil Bourque 25/05
3
Não sei o que pode estar desatualizado - esse é o problema. As páginas dizem claramente em fonte grande na parte superior This manual page is for Mac OS X version 10.9. A barra superior da página diz "Biblioteca de documentos aposentados". E "legado" na indústria de TI definitivamente é um eufemismo para "desatualizado, não mais recomendado ou aplicável". Portanto, embora este site possa ser melhor que nada, certamente não é bom para as discussões atuais. Agradeço sua postagem, gostaria que houvesse edições atualizadas e com versões específicas das páginas de manual na web.
Basil Bourque 25/05
9
@samh Olá, esta URL está morta agora #
SebMa
10
Parece que a Apple derrubou a seção do site ... algum novo local?
0xF2
11
@ 0xF2 Você pode acessar versões antigas no archive.org, mas a Apple parou de atualizá-las no OS X 10.9.
Zenexer 7/01/19
3

Olá do futuro mundo de 2019!

Infelizmente, parece que uma pesquisa na web site:opensource.apple.com/source stat.1ainda é o estado fundamental das coisas, se você quiser documentação "oficial" no site apple.com.

Aqui estão algumas alternativas:

  • Páginas de manual de Darwin na Wayback Machine
    • esta é uma captura de maio de 2018, para OS X 10.9 (Mavericks), e ainda existem alguns buracos; portanto, você pode precisar voltar mais no tempo com a Wayback Machine para obter algumas das páginas
  • Páginas de manual do Mojave (10.14) de manual do em unix.com
    • o design do site aqui usa um ex cru quantidade ciating de espaços em branco, e você provavelmente vai precisar para fazer zoom para fora para ver as páginas do manual na sua totalidade

Atualização: A propósito, você pode formatar a fonte roff bruta das páginas de manual em opensource.apple.com em algo legível por humanos como este:

  1. copie o URL "texto simples":

    insira a descrição da imagem aqui

  2. busque esse URL com curle formate-o para visualização na tela com 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

    Algumas notas laterais sobre esse groffcomando:

    • adicione -rLL=${COLUMNS}npara usar toda a largura do seu terminal, se 80 colunas não fizerem isso por você; o mancomando geralmente faz alguma mágica para detectar automaticamente isso no tamanho do terminal ( referência )
    • você pode substituir groff -man -T ps > ~/Desktop/grep.1.psa última parte para obter uma bela página de manual PostScript que você pode abrir e imprimir com o Preview.app, se você preferir
TheDudeAbides
fonte
basicamente "Olá do mundo futuro" está correto para cada resposta que existe.
Max Ried
Se o mundo futuro realmente resolveu o seu problema, e se preocupou em relatar. Mas, às vezes, o mundo futuro apenas bloqueia seu fio, sem resolução para ninguém . :/
TheDudeAbides 14/11/19
2

Existem algumas páginas de manual do MacOS aqui , embora eu não saiba o quão completa é a lista.

benwiggy
fonte
O SS64 é um recurso realmente bom para quem trabalha em um ambiente de linha de comando, em qualquer sistema operacional. É bem estruturado, abrangente e organizado. Se apenas a documentação oficial da Microsoft (ou da Apple) estivesse de acordo com esse padrão .
TheDudeAbides 14/11/19