.\"***********************************************************************)
.\"*                                                                     *)
.\"*                             ocamlbuild                              *)
.\"*                                                                     *)
.\"*  Nicolas Pouillard, Berke Durak, projet Gallium, INRIA Rocquencourt *)
.\"*                                                                     *)
.\"*  Copyright 2007 Institut National de Recherche en Informatique et   *)
.\"*  en Automatique.  All rights reserved.  This file is distributed    *)
.\"*  under the terms of the Q Public License version 1.0.               *)
.\"*                                                                     *)
.\"***********************************************************************)
.\"
.TH OCAMLBUILD 1

.SH "نام (NAME)"
ocamlbuild \- ابزار کامپایل و ساخت پروژه‌های OCaml


.SH "خلاصه دستور (SYNOPSIS)"
.B ocamlbuild
[
.B \-Is \ dir1,...
]
[
.BI \-libs \ lib1,...
]
[
.BI \-lflags \ flag1,...
]
[
.BI \-pp \ flags
]
[
.BI \-tags \ tag1,...
]
[
.B \-j \ parallel-jobs
]
.I target.native
[
.B \-\- arg1 arg2 ...
]

.I (همان گزینه‌ها)

.SH "توضیحات (DESCRIPTION)"

.BR ocamlbuild (1)
فرآیند کامپایل پروژه OCaml شما را مدیریت و هماهنگ می‌کند. عملکرد آن مشابه
.BR make (1)
است، با این تفاوت که به‌طور اختصاصی برای کامپایل خودکار بیشتر پروژه‌های OCaml با کمترین ورودی از سوی کاربر طراحی شده است.

.BR ocamlbuild
باید در ریشه درخت یک پروژه پاک (به‌عنوان مثال، بدون فایل‌های کامپایل باقی‌مانده) اجرا شود. با مشخص کردن یک یا چند هدف برای کامپایل، زیرپوشه‌های لازم را جهت جمع‌آوری اطلاعات درباره فایل‌های مختلف موجود پویش می‌کند، ابزارهایی مانند
.BR ocamldep (1)
را برای استخراج اطلاعات وابستگی اجرا می‌نماید، و فایل‌های اختیاری را که رفتار آن را دقیق‌تر تنظیم می‌کنند گردآوری می‌کند.
نام‌های هدف بسیار بااهمیت هستند.

.SH "نام‌های هدف (TARGET NAMES)"
.BR ocamlbuild
از مجموعه‌ای از قراردادهای نام‌گذاری هدف برای تعیین نوع اشیای تولیدی استفاده می‌کند. نام‌های هدف به شکل
.BR base.extension
هستند که در آن
.BR base
معمولاً نام ماژول پایه OCaml است و
.BR extension
نوع شیئی را که قرار است از آن فایل تولید شود مشخص می‌کند -- یک فایل اجرایی بایت‌کد، یک فایل اجرایی نیتیو (native)، مستندات و غیره.
البته پسوندهایی مانند
.BR .cmo,
.BR .cma,
.BR .cmi...
به معادل‌های معمول خود نگاشت می‌شوند. در اینجا فهرستی از مهم‌ترین پسوندهای ویژه
.BR ocamlbuild \&
آورده شده است:

.TP 2i
.B .native
فایل اجرایی کد نیتیو (Native)

.TP 2i
.B .byte
فایل اجرایی بایت‌کد (Bytecode)

.TP 2i
.B .inferred.mli
رابط استنتاج‌شده با
.BR ocamlc \-i

.TP 2i
.B .docdir/index.html
مستندات HTML تولیدشده با
.BR ocamldoc

.PP.SH "گزینه‌ها (OPTIONS)"

گزینه‌های خط فرمان زیر توسط
.BR ocamlbuild (1)
شناخته می‌شوند.

.TP
\fB\-version\fR
نمایش نسخه
.TP
\fB\-\-version\fR
همانند \-version
.TP
\fB\-vnum\fR
نمایش شماره نسخه
.TP
\fB\-\-vnum\fR
همانند \-vnum
.TP
\fB\-quiet\fR
به حداقل رساندن پیام‌های خروجی تا جای ممکن
.TP
\fB\-verbose\fR <level>
تنظیم سطح پرگویی خروجی در مقیاسی از 0 تا 8 (شامل هر دو)
.TP
\fB\-documentation\fR
نمایش قوانین و پرچم‌ها
.TP
\fB\-log\fR <file>
تعیین فایل گزارش (log)
.TP
\fB\-no\-log\fR
بدون فایل گزارش
.TP
\fB\-clean\fR
حذف دایرکتوری ساخت و سایر فایل‌ها، سپس خروج
.TP
\fB\-r\fR
پیمایش دایرکتوری‌ها به‌صورت پیش‌فرض (درست: پیمایش)
.TP
\fB\-I\fR <path>
افزودن به دایرکتوری‌های include
.TP
\fB\-Is\fR <path,...>
(همانند بالا، اما فهرستی جداشده با کاما یا فاصله را می‌پذیرد)
.TP
\fB\-X\fR <path>
دایرکتوری برای نادیده‌گرفتن
.TP
\fB\-Xs\fR <path,...>
(همانند بالا)
.TP
\fB\-lib\fR <flag>
پیوند به این کتابخانه ocaml
.TP
\fB\-libs\fR <flag,...>
(همانند بالا)
.TP
\fB\-mod\fR <module>
پیوند به این ماژول ocaml
.TP
\fB\-mods\fR <module,...>
(همانند بالا)
.TP
\fB\-pkg\fR <package>
پیوند به این بسته findlib ocaml
.TP
\fB\-pkgs\fR <package,...>
(همانند بالا)
.TP
\fB\-package\fR <package>
(همانند بالا)
.TP
\fB\-syntax\fR <syntax>
مشخص‌کردن نحو با استفاده از ocamlfind
.TP
\fB\-lflag\fR <flag>
افزودن به پرچم‌های پیونددهی ocamlc
.TP
\fB\-lflags\fR <flag,...>
(همانند بالا)
.TP
\fB\-cflag\fR <flag>
افزودن به پرچم‌های کامپایل ocamlc
.TP
\fB\-cflags\fR <flag,...>
(همانند بالا)
.TP
\fB\-docflag\fR <flag>
افزودن به پرچم‌های ocamldoc
.TP
\fB\-docflags\fR <flag,...>
(همانند بالا)
.TP
\fB\-yaccflag\fR <flag>
افزودن به پرچم‌های ocamlyacc
.TP
\fB\-yaccflags\fR <flag,...>
(همانند بالا)
.TP
\fB\-lexflag\fR <flag>
افزودن به پرچم‌های ocamllex
.TP
\fB\-lexflags\fR <flag,...>
(همانند بالا)
.TP
\fB\-ppflag\fR <flag>
افزودن به پرچم‌های پیش‌پردازش ocaml
.TP
\fB\-pp\fR <flag,...>
(همانند بالا)
.TP
\fB\-tag\fR <tag>
افزودن به برچسب‌های پیش‌فرض
.TP
\fB\-tags\fR <tag,...>
(همانند بالا)
.TP
\fB\-plugin\-tag\fR <tag>
استفاده از این برچسب هنگام کامپایل افزونه myocamlbuild.ml
.TP
\fB\-plugin\-tags\fR <tag,...>
(همانند بالا)
.TP
\fB\-tag\-line\fR <tag>
استفاده از این سطر برچسب‌ها (مشابه فایل _tags)
.TP
\fB\-show\-tags\fR <path>
نمایش برچسب‌هایی که برای آن مسیر اعمال می‌شوند
.TP
\fB\-ignore\fR <module,...>
عدم تلاش برای ساخت این ماژول‌ها
.TP
\fB\-no\-links\fR
عدم ایجاد پیوند برای هدف‌های نهایی تولیدشده
.TP
\fB\-no\-skip\fR
رد نکردن ماژول‌هایی که توسط ocamldep درخواست شده‌اند اما قابل ساخت نیستند
.TP
\fB\-no\-hygiene\fR
عدم اعمال قوانین بررسی سلامت (sanity-check)
.TP
\fB\-no\-plugin\fR
عدم ساخت myocamlbuild.ml
.TP
\fB\-no\-stdlib\fR
نادیده نگرفتن ماژول‌های stdlib
.TP
\fB\-dont\-catch\-errors\fR
عدم گرفتن و نمایش استثناها (مفید برای نمایش پشته فراخوانی)
.TP
\fB\-just\-plugin\fR
تنها myocamlbuild.ml ساخته شود
.TP
\fB\-byte\-plugin\fR
استفاده از بایت‌کد به‌جای افزونه بومی (native)
.TP
\fB\-plugin\-option\fR
استفاده از این گزینه تنها در زمان اجرای افزونه
.TP
\fB\-sanitization\-script\fR
تغییر نام فایل اسکریپت پاک‌سازی ایجادشده
.TP
\fB\-no\-sanitize\fR
عدم ایجاد اسکریپت پاک‌سازی
.TP
\fB\-nothing\-should\-be\-rebuilt\fR
شکست در صورت نیاز به بازسازی هر چیزی
.TP
\fB\-classic\-display\fR
نمایش دستورهای اجراشده به روش قدیمی
.TP
\fB\-use\-menhir\fR
استفاده از menhir به‌جای ocamlyacc
.TP
\fB\-use\-jocaml\fR
استفاده از کامپایلرهای jocaml به‌جای کامپایلرهای ocaml
.TP
\fB\-use\-ocamlfind\fR
استفاده از پوشش‌دهنده \(aqocamlfind\(aq به‌جای استفاده مستقیم از Findlib برای تعیین آرگومان‌های خط فرمان. برای غیرفعال‌کردن از \-no\-ocamlfind استفاده کنید. مستلزم \-plugin\-use\-ocamlfind است.
.TP
\fB\-no\-ocamlfind\fR
عدم استفاده از ocamlfind. مستلزم \-plugin\-no\-ocamlfind است..TP
\fB\-plugin\-use\-ocamlfind\fR
استفاده از لفاف \(aqocamlfind\(aq برای ساخت myocamlbuild.ml
.TP
\fB\-plugin\-no\-ocamlfind\fR
عدم استفاده از ocamlfind برای ساخت myocamlbuild.ml
.TP
\fB\-toolchain\fR <toolchain>
تنظیم زنجیره ابزار Findlib مورد استفاده. برای ساخت myocamlbuild.ml همواره از زنجیره ابزار پیش‌فرض استفاده می‌شود.
.TP
\fB\-j\fR <N>
اجازه دادن به N کار به صورت هم‌زمان (۰ برای نامحدود)
.TP
\fB\-build\-dir\fR <path>
تنظیم دایرکتوری ساخت (مستلزم no\-links)
.TP
\fB\-install\-lib\-dir\fR <path>
تنظیم دایرکتوری کتابخانه‌های نصبی
.TP
\fB\-install\-bin\-dir\fR <path>
تنظیم دایرکتوری باینری‌های نصبی
.TP
\fB\-where\fR
نمایش دایرکتوری کتابخانه‌های نصبی
.TP
\fB\-which\fR <command>
نمایش مسیر دستور ابزار
.TP
\fB\-ocamlc\fR <command>
تنظیم کامپایلر بایت‌کد OCaml
.TP
\fB\-plugin\-ocamlc\fR <command>
تنظیم کامپایلر بایت‌کد OCaml مورد استفاده برای ساخت myocamlbuild.ml (فقط)
.TP
\fB\-ocamlopt\fR <command>
تنظیم کامپایلر بومی OCaml
.TP
\fB\-plugin\-ocamlopt\fR <command>
تنظیم کامپایلر بومی OCaml مورد استفاده برای ساخت myocamlbuild.ml (فقط)
.TP
\fB\-ocamldep\fR <command>
تنظیم ابزار وابستگی OCaml
.TP
\fB\-ocamldoc\fR <command>
تنظیم تولیدکننده مستندات OCaml
.TP
\fB\-ocamlyacc\fR <command>
تنظیم ابزار ocamlyacc
.TP
\fB\-menhir\fR <command>
تنظیم ابزار menhir (پس از \-use\-menhir استفاده شود)
.TP
\fB\-ocamllex\fR <command>
تنظیم ابزار ocamllex
.TP
\fB\-ocamlmklib\fR <command>
تنظیم ابزار ocamlmklib
.TP
\fB\-ocamlmktop\fR <command>
تنظیم ابزار ocamlmktop
.TP
\fB\-ocamlrun\fR <command>
تنظیم ابزار ocamlrun
.TP
\fB\-\-\fR
توقف پردازش آرگومان‌ها؛ آرگومان‌های باقی‌مانده به برنامه کاربر داده می‌شوند
.TP
\fB\-help\fR
نمایش این فهرست از گزینه‌ها
.TP
\fB\-\-help\fR
نمایش این فهرست از گزینه‌ها

.PP
.SH "همچنین ببینید (SEE ALSO)"
راهنمای
.BR ocamlbuild ،
.BR ocaml (1)،
.BR make (1).
.br
.I راهنمای کاربر OCaml، فصل \(lqBatch compilation\(rq.