.\"**************************************************************************
.\"*                                                                        *
.\"*                                 OCaml                                  *
.\"*                                                                        *
.\"*             Xavier Leroy, projet Cristal, INRIA Rocquencourt           *
.\"*                                                                        *
.\"*   Copyright 1996 Institut National de Recherche en Informatique et     *
.\"*     en Automatique.                                                    *
.\"*                                                                        *
.\"*   All rights reserved.  This file is distributed under the terms of    *
.\"*   the GNU Lesser General Public License version 2.1, with the          *
.\"*   special exception on linking described in the file LICENSE.          *
.\"*                                                                        *
.\"**************************************************************************
.\"
.TH OCAMLDEP 1

.SH "نام (NAME)"
ocamldep \- تولیدکننده وابستگی‌ها برای OCaml

.SH "خلاصه دستور (SYNOPSIS)"
.B ocamldep
[
.I options
]
.I filename ...

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

دستور
.BR ocamldep (1)
مجموعه‌ای از فایل‌های منبع OCaml (فایل‌های .ml و .mli) را برای ارجاعات به واحدهای کامپایل خارجی اسکن کرده، و خطوط وابستگی را در قالبی مناسب برای ابزار
.BR make (1)
تولید می‌کند. این کار تضمین می‌کند که make فایل‌های منبع را به ترتیب صحیح کامپایل کند و در صورت تغییر یک فایل منبع، فایل‌هایی را که نیاز به کامپایل مجدد دارند بازکامپایل نماید.

نحوه استفاده متداول به این صورت است:
.P
ocamldep
.I options
*.mli *.ml > .depend
.P
که در آن depend. فایلی است که باید شامل وابستگی‌ها باشد.

وابستگی‌ها هم برای کامپایل با کامپایلر بایت‌کد
.BR ocamlc (1)
و هم با کامپایلر کد بومی
.BR ocamlopt (1)
تولید می‌شوند.

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

گزینه‌های خط فرمان زیر توسط
.BR ocamldep (1)
شناسایی می‌شوند.
.TP
.B \-absname
نمایش نام فایل‌ها به صورت مطلق در پیام‌های خطا.
.TP
.B \-no-absname
عدم تلاش برای نمایش نام فایل‌ها به صورت مطلق در پیام‌های خطا (پیش‌فرض).
.TP
.B \-all
تولید وابستگی‌ها بر روی تمامی فایل‌های مورد نیاز، به جای فرض وابستگی‌های ضمنی.
.TP
.B \-allow\-approx
امکان بازگشت به تقریب مبتنی بر تحلیل‌گر لغوی (lexer) هنگام شکست در تجزیه.
.TP
.B \-as\-map
برای فایل‌های بعدی، وابستگی‌های به تعویق افتاده برای نام‌های مستعار ماژول گنجانده نشود.
این گزینه فرض می‌کند که آن‌ها با استفاده از گزینه‌های "\-no\-alias\-deps \-w \-49" کامپایل می‌شوند، و آن فایل‌ها یا رابط کاربری آن‌ها با گزینه "\-map" هنگام محاسبه وابستگی‌ها برای سایر فایل‌ها ارسال می‌شوند. همچنین توجه داشته باشید برای اینکه وابستگی‌ها در پیاده‌سازی یک فایل map صحیح باشند، رابط آن نباید هیچ‌یک از نام‌های مستعار موجود در آن را محدود (coerce) کند.
.TP
.B \-debug\-map
دامپ کردن نگاشت وابستگی‌های به تعویق افتاده برای هر فایل map.
.TP
.BI \-I " directory"
افزودن دایرکتوری داده‌شده به فهرست دایرکتوری‌های مورد جستجو برای فایل‌های منبع. اگر فایل منبع foo.ml به یک واحد کامپایل خارجی Bar اشاره کند، وابستگی به رابط آن واحد یعنی bar.cmi تنها در صورتی تولید می‌شود که منبع bar در دایرکتوری جاری یا در یکی از دایرکتوری‌های مشخص‌شده با
.BR \-I
یافت شود. در غیر این صورت، فرض می‌شود Bar یک ماژول از کتابخانه استاندارد است و هیچ وابستگی‌ای تولید نمی‌شود. برای برنامه‌هایی که در چندین دایرکتوری گسترده شده‌اند، توصیه می‌شود به
.BR ocamldep (1)
همان گزینه‌های
.B \-I
داده شود که به کامپایلر ارسال می‌شوند.
.TP
.B \-nocwd
دایرکتوری کاری جاری به فهرست دایرکتوری‌های include اضافه نشود.
.TP
.BI \-impl " file"
پردازش
.IR file
به عنوان یک فایل .ml.
.TP
.BI \-intf " file"
پردازش
.IR file
به عنوان یک فایل .mli.
.TP
.BI \-keywords " version+list"
تنظیم کلمات کلیدی مطابق با مشخصه
.IR version+list .
.TP
.BI \-map " file"
خواندن و انتشار وابستگی‌های به تعویق افتاده برای نام‌های مستعار ماژول در
.IR file ،
به طوری که فایل‌های بعدی در صورت استفاده از ماژول‌های مستعار صادرشده، به آن‌ها وابسته باشند.
.TP
.BI \-ml\-synonym " .ext"
در نظر گرفتن پسوند داده‌شده (همراه با نقطه ابتدایی) به عنوان مترادفی برای .ml.
.TP
.BI \-mli\-synonym " .ext"
در نظر گرفتن پسوند داده‌شده (همراه با نقطه ابتدایی) به عنوان مترادفی برای .mli.
.TP
.B \-modules
تولید خروجی وابستگی‌های خام به فرمت
.IR filename : " Module1 Module2" " ... " ModuleN
که در آن
.IR Module1 ", ...," " ModuleN"
نام واحدهای کامپایلی هستند که درون فایل
.IR filename
به آن‌ها ارجاع داده شده است، اما این نام‌ها به نام فایل‌های منبع تبدیل نمی‌شوند. چنین وابستگی‌های خامی نمی‌توانند توسط
.BR make (1)
استفاده شوند، اما می‌توانند توسط سایر ابزارها مانند
.BR Omake (1)
پس‌پردازش شوند.
.TP
.BI \-native
تولید وابستگی‌ها برای یک برنامه کد بومی خالص (بدون نسخه بایت‌کد). هنگامی که یک فایل پیاده‌سازی (فایل .ml) فاقد فایل رابط صریح (فایل .mli) باشد،
.BR ocamldep (1)
وابستگی‌هایی را به فایل کامپایل‌شده بایت‌کد (فایل .cmo) ایجاد می‌کند تا تغییرات رابط را منعکس کند. این امر می‌تواند باعث کامپایل مجدد غیرضروری بایت‌کد برای برنامه‌هایی شود که تنها به صورت کد بومی کامپایل می‌شوند. فلگ
.B \-native
باعث می‌شود وابستگی‌ها به جای فایل‌های .cmo، روی فایل‌های کامپایل‌شده بومی (.cmx) تولید شوند. (اگر تمامی فایل‌های منبع دارای فایل‌های رابط صریح .mli باشند، این فلگ تفاوتی ایجاد نمی‌کند).
.TP
.B \-one-line
خروجی دادن یک خط برای هر فایل، بدون در نظر گرفتن طول آن.
.TP
.BI \-open " module"
فرض بر اینکه ماژول
.IR module
پیش از تجزیه هر یک از فایل‌های بعدی باز (open) شده است.
.TP
.BI \-pp " command"
باعث می‌شود
.BR ocamldep (1)
دستور
.I command
مشخص‌شده را به عنوان یک پیش‌پردازنده برای هر فایل منبع فراخوانی کند.
.TP
.BI \-ppx " command"
هدایت درخت نحو انتزاعی از طریق پیش‌پردازنده
.IR command .
.TP
.B \-shared
تولید وابستگی‌ها برای فایل‌های پلاگین بومی (.cmxs) علاوه بر فایل‌های کامپایل‌شده بومی (.cmx).
.TP
.B \-slash
(در ویندوز) استفاده از اسلش / به جای بک‌اسلش \\ در مسیر فایل‌ها. در یونیکس، این گزینه هیچ اثری ندارد.
.TP
.B \-no\-slash
(در ویندوز) حفظ هرگونه بک‌اسلش \\ در مسیر فایل‌ها. در یونیکس، این گزینه هیچ اثری ندارد.
.TP
.B \-sort
مرتب‌سازی فایل‌ها بر اساس وابستگی‌های آن‌ها.
.TP
.B \-version
چاپ رشته نسخه و خروج.
.TP
.B \-vnum
چاپ شماره نسخه کوتاه و خروج.
.TP
.BI \-args " file"
خواندن آرگومان‌های خط فرمان اضافی که با خط جدید جدا شده‌اند از
.IR file .
.TP
.BI \-args0 " file"
خواندن آرگومان‌های خط فرمان اضافی که با نویسه NUL جدا شده‌اند از
.IR file .
.TP
.BR \-help " یا " \-\-help
نمایش خلاصه کوتاهی از نحوه استفاده و خروج.

.SH "همچنین ببینید (SEE ALSO)"
.BR ocamlc "(1), " ocamlopt (1).
.br
.IR The\ OCaml\ user's\ manual ,
فصل "Dependency generator".