macOS
Homebrew確認済み · 100%
brew install naturaldocslocal Homebrew formula metadata
MacPorts確認済み · 94%
sudo port install naturaldocsMacPorts ports tree · textproc/naturaldocs/Portfile · ソース: api.github.com
brew
naturaldocs を Homebrew, apt, MacPorts, dnf でインストール
naturaldocs のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。
インストール
追加のインストールコマンド
Linux
Debian apt確認済み · 92%
sudo apt install naturaldocsDebian stable package indexes · naturaldocs · ソース: deb.debian.org
Fedora dnf確認済み · 92%
sudo dnf install NaturalDocsFedora Rawhide package metadata · NaturalDocs · ソース: dl.fedoraproject.org
概要
パッケージ概要
Extensible, multi-language documentation generator
プロジェクトリンク
コマンドとエイリアス
- naturaldocs
履歴
プロジェクトの歴史と使われ方
Natural Docs is a multi-language source-code documentation generator built around comments that stay readable in the source file. Its niche is documentation that feels closer to prose than annotation syntax, while still producing browsable HTML output.
プロジェクトの歴史
The official About page says Greg Valure wrote Natural Docs after rejecting heavier documentation workflows, open sourced it, and has maintained it since its first release in 2003. The same page records the major architectural shift from the original Perl implementation to Natural Docs 2.0, a C# rewrite with a new engine.
The GitHub repository for the 2.x code was created on 2017-04-17. Public GitHub releases include Natural Docs 2.3 on 2023-09-12, 2.3.1 on 2025-02-01, and 2.4 beta work in 2026.
採用の歴史
Natural Docs has a long tail rather than a large modern package-manager footprint. The official site says it is used by educational institutions, government, companies, and individuals, and points to public pages generated by Natural Docs as evidence. Homebrew analytics consulted on 2026-07-01 listed 113 installs over the preceding 365 days.
使われ方
Users configure a project with `Project.txt`, which tells Natural Docs which source folders to scan, where to write generated documentation, and project metadata such as title. The reference documentation says command-line options can override parts of Project.txt, partly for compatibility with Natural Docs 1.x workflows.
パッケージ好きにとっての重要性
Natural Docs is interesting to package maintainers because it spans two eras of language tooling: old Perl-era source documentation and the 2.x C#/Mono packaging story. The Homebrew formula still depends on Mono, which makes it a reminder that documentation generators often carry runtime packaging constraints long after their core idea stabilizes.
タイムライン
- 2003: First Natural Docs release, according to the official About page.
- 2015-05-04: Natural Docs 2.0 development release tag appears in the GitHub repository.
- 2017-04-17: GitHub repository created for the 2.x source tree.
- 2023-09-12: Natural Docs 2.3 released.
- 2025-02-01: Natural Docs 2.3.1 released.
- 2026-05-26: Natural Docs 2.4 Beta 1 released as a prerelease.
Related projects
- Comparable documentation generators include Doxygen, Javadoc-style tooling, Sphinx, and language-native documentation systems, but Natural Docs' distinguishing feature is its plain-English comment style.
ソース
セキュリティ状態
リスクレベル: グリーン
narrow executable package without higher-risk signals.
リスク分類器
リスク グリーン · 信頼度 低 · appliance
理由
- narrow executable package without higher-risk signals
信号
- metadata:no-higher-risk-signals
インストール挙動
- formula メタデータに Homebrew post-install フックは記録されていません。
- Homebrew bottle メタデータは 1 個のプラットフォームターゲットで利用できます。
- 1 件の実行時依存関係とともにインストールされます。
推奨レビュー
エージェントに無人実行させる前に、このツールが平文の認証情報を読むか、リモート状態を書き込むか、成果物を公開するか、プラグインを起動するかを確認してください。
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
Project.txt in the project configuration folder
実行可能ファイル
インストールされる実行可能ファイル
| コマンド | 種類 | 公開範囲 | メモ |
|---|---|---|---|
naturaldocs | cli | グローバル実行可能ファイル |
鮮度
バージョンと鮮度
これらの信号は、ページ生成時期、パッケージマネージャの活動、上流リリース比較を分けて示します。バージョン遅れは、証拠 URL と比較可能なバージョンがある場合だけ警告されます。
ページ生成日2026-07-26
マネージャ版2.3.1
マネージャ更新日
ローカルデータOK
上流not checked
検出された最新未検出
- 情報No package-manager update timestamp was available.信頼度 低
- 情報Release/tag comparison is only available for GitHub repositories.https://www.naturaldocs.org/信頼度 none
インストールメタデータ
パッケージメタデータ
| パッケージキー | brew:naturaldocs |
|---|---|
| バージョン | 2.3.1 |
| パッケージマネージャ | Homebrew |
| パッケージマネージャページ | https://formulae.brew.sh/formula/naturaldocs |
| ホームページ | https://www.naturaldocs.org/ |
| リポジトリ | https://github.com/NaturalDocs/NaturalDocs |
| 上流ドキュメント | https://www.naturaldocs.org/getting_started |
| ライセンス | AGPL-3.0-only |
| ソースアーカイブ | https://downloads.sourceforge.net/project/naturaldocs/Stable%20Releases/2.3.1/Natural_Docs_2.3.1.zip |
| 依存関係 | mono |
| Bottle | 利用可能 (対象 all) |
| Homebrew post-install | 未定義 |
| サービス | 宣言なし |
レジストリ情報
ソースデータベース詳細
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | naturaldocs |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
ソースデータベース一致
他のパッケージマネージャ記録
一致は外部パッケージマネージャインデックスから取得され、ローカルの Automic Vault パッケージリンクとは分けて表示されます。
Debian apt95%
naturaldocs 1.51-4
extensible, multi-language documentation generator
sudo apt install naturaldocs- Section: devel
- Architecture: all
- 1 依存関係
- normalized package name match
- 一致条件: Naturaldocs
Ubuntu apt95%
naturaldocs 1:1.5.1-0ubuntu1
an extensible, multi-language documentation generator
sudo apt install naturaldocs- Section: universe/devel
- Architecture: all
- 1 依存関係
- normalized package name match
- 一致条件: Naturaldocs
dnf95%
NaturalDocs 1.52-36.fc44
Documentation generator for multiple programming languages
sudo dnf install NaturalDocs- License: GPL-2.0-or-later
- Category: Unspecified
- Architecture: noarch
- Source Package: NaturalDocs
- 3 依存関係
- 3 提供
- normalized package name match
- 一致条件: Naturaldocs
MacPorts95%
naturaldocs
sudo port install naturaldocs- normalized package name match
- 一致条件: Naturaldocs
ソース経路
リポジトリデータから生成
このページは scripts/generate-pkg-sqlite.py が生成した非公開のパッケージ SQLite アーティファクトから av-web によって提供されます。
Combined YAML source
View the package source record on GitHub.
使用ソース
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment