lexgrog - 클라우드에서의 온라인

프로그램:

이름

lexgrog - 매뉴얼 페이지의 헤더 정보 구문 분석

개요

렉스그로그 [-m|-c] [-dfw?V] [-E 부호화] 파일 ...

기술

렉스그로그 전통적인 "groff 추측" 유틸리티를 구현한 것입니다. 법률. 그것은 읽습니다
매뉴얼 페이지 소스 파일 또는 사전 형식화된 명령줄의 파일 목록
"cat" 페이지에서 사용되는 이름과 설명을 표시합니다. 때마침 과 뭐가Walk Through California 프로그램,
매뉴얼 페이지에 전달되기 전에 필요한 전처리 필터 목록 노프 or
troff또는 둘 다입니다.

입력 형식이 잘못된 경우 렉스그로그 "parse failed"가 인쇄됩니다. 이것은 유용할 수 있습니다
매뉴얼 페이지의 정확성을 확인해야 하는 외부 프로그램. 다음 중 하나인 경우 렉스그로그님의 입력
파일이 "-"이면 표준 입력에서 읽습니다. 입력 파일이 압축된 경우
압축이 풀린 버전은 자동으로 읽혀집니다.

옵션

-d, -디버그
디버깅 정보를 인쇄합니다.

-m, --남성
입력을 매뉴얼 페이지 소스 파일로 구문 분석합니다. 둘 다 아닌 경우 이것이 기본값입니다. --남성 ...도 아니다
--고양이 주어진다.

-c, --고양이
입력을 미리 형식화된 매뉴얼 페이지("cat 페이지")로 구문 분석합니다. --남성 과 --고양이 아닐 수 있습니다
동시에 주어집니다.

-w, --무엇인가요
다음에서 사용하는 대로 매뉴얼 페이지 헤더의 이름과 설명을 표시합니다. 때마침 과
뭐가. 둘 다 아닌 경우 이것이 기본값입니다. --무엇인가요 ...도 아니다 --필터 주어진다.

-f, --필터
포맷하기 전에 매뉴얼 페이지를 전처리하는 데 필요한 필터 목록을 표시합니다.
과 노프 or troff.

-E 부호화, --부호화 부호화
페이지에 대해 추측된 문자 집합을 재정의합니다. 부호화.

-?, --도움
도움말 메시지를 인쇄하고 종료합니다.

--용법
짧은 사용 메시지를 인쇄하고 종료합니다.

-V, --번역
버전 정보를 표시합니다.

EXIT 지위

0 성공적인 프로그램 실행.

1 사용법 오류.

2 렉스그로그 하나 이상의 입력 파일을 구문 분석하지 못했습니다.

사용 예

$ 렉스그로그 맨.1
man.1: "man - 온라인 참조 매뉴얼에 대한 인터페이스"
$ lexgrog -fw man.1
man.1 (t): "man - 온라인 참조 매뉴얼에 대한 인터페이스"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - 매뉴얼 페이지 설명 표시"
$ lexgrog가 깨졌습니다.1
broken.1: 구문 분석 실패

무엇인가요 파싱

맨드 (다음과 동일한 코드를 사용합니다. 렉스그로그)는 이름 각 상단의 섹션
각각에 문서화된 기능의 이름과 설명을 찾는 매뉴얼 페이지. 하는 동안
파서는 다음과 같은 다양한 형식을 처리해야 하기 때문에 매우 관대합니다.
역사적으로 사용되어 왔기 때문에 때로는 필요한 정보를 추출하지 못할 수도 있습니다.

기존 방식을 사용하는 경우 사람 매크로 세트, 올바른 이름 섹션은 다음과 같습니다
이:

.SH 이름
foo \- 무언가를 수행하는 프로그램

일부 수동 호출기에는 '\-'가 표시된 것과 정확히 일치해야 합니다. 맨드 내성이 더 강하지만
그럼에도 불구하고 다른 시스템과의 호환성을 위해
백슬래시.

왼쪽에는 쉼표로 구분된 여러 이름이 있을 수 있습니다. 다음을 포함하는 이름
특정 잘못된 형식의 병리적 동작을 피하기 위해 공백은 무시됩니다. 이름
섹션. 오른쪽의 텍스트는 자유 형식이며 여러 페이지에 걸쳐 표시될 수 있습니다.
윤곽. 설명이 다른 여러 기능이 동일한 문서에 문서화되어 있는 경우
매뉴얼 페이지에서는 다음 형식이 사용됩니다.

.SH 이름
foo, bar \- 어떤 작업을 수행하는 프로그램
.BR
baz \- 아무것도 하지 않는 프로그램

(.PP와 같은 새 문단을 시작하는 매크로는 나누기 매크로 대신 사용될 수 있습니다.
.br.)

BSD 파생을 사용하는 경우 mdoc 매크로 세트, 올바른 이름 섹션은 다음과 같습니다
이:

.Sh 이름
.Nm foo
.Nd 어떤 일을 하는 프로그램

구문 분석이 실패하는 데는 몇 가지 일반적인 이유가 있습니다. 때로는 매뉴얼 작성자
페이지는 '.SH NAME'을 '.SH MYPROGRAM'으로 바꾼 다음 맨드 섹션을 찾을 수 없습니다
필요한 정보를 추출하는 것입니다. 때때로 작성자는 NAME 섹션을 포함하지만
'이름\-설명' 대신 자유 형식 텍스트를 배치하세요. 그러나 모든 구문
위와 유사한 내용은 허용되어야 합니다.

onworks.net 서비스를 사용하여 온라인으로 Lexgrog를 사용하세요.