.\"************************************************************************** .\"* * .\"* OCaml * .\"* * .\"* Xavier Leroy, projet Cristal, INRIA Rocquencourt * .\"* * .\"* Copyright 2001 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 OCAMLDEBUG 1 .SH "نام (NAME)" ocamldebug \- اشکال‌زدای بازپخش در سطح کد منبع برای OCaml .SH "خلاصه دستور (SYNOPSIS)" .B ocamldebug .RI [ " options " ] " program " [ " arguments " ] .SH "توضیحات (DESCRIPTION)" .B ocamldebug اشکال‌زدای بازپخش در سطح کد منبع برای OCaml است. پیش از اینکه بتوان از اشکال‌زدا استفاده کرد، برنامه باید با گزینهٔ .B \-g کامپایل و پیوند داده (link) شود: تمام فایل‌های .cmo و .cma که بخشی از برنامه هستند باید با .BR ocamlc\ \-g ایجاد شده باشند، و باید به‌وسیلهٔ .BR ocamlc\ \-g به یکدیگر پیوند داده شوند. کامپایل کردن با .B \-g هیچ جریمه‌ای بر زمان اجرای برنامه‌ها تحمیل نمی‌کند: فایل‌های شیء و فایل‌های اجرایی بایت‌کد حجیم‌تر بوده و تولید آن‌ها زمان بیشتری می‌برد، اما فایل‌های اجرایی دقیقاً با همان سرعتی اجرا می‌شوند که گویی بدون .B \-g کامپایل شده‌اند. .SH "گزینه‌ها (OPTIONS)" خلاصه‌ای از گزینه‌ها در زیر آمده است. برای توضیحات کامل، به مستندات html در بستهٔ ocaml-doc مراجعه کنید. .TP .BI \-c " count" تنظیم حداکثر تعداد نقاط وارسی (checkpoints) فعال به‌طور هم‌زمان روی .IR count . .TP .BI \-cd " dir" اجرای برنامهٔ اشکال‌زدا از دایرکتوری کاریِ .IR dir ، به‌جای دایرکتوری کاری فعلی (همچنین دستور .B cd را ببینید). .TP .B \-emacs به اشکال‌زدا اعلام می‌کند که تحت Emacs در حال اجرا است (برای اطلاعات دربارهٔ نحوهٔ اجرای اشکال‌زدا تحت Emacs، .I "The\ OCaml\ user's\ manual" را ببینید). این گزینه به‌طور ضمنی شامل .B \-machine-readable نیز می‌شود. .TP .BI \-I " directory" افزودن .I directory به فهرست دایرکتوری‌هایی که برای فایل‌های منبع و فایل‌های کامپایل‌شده جستجو می‌شوند (همچنین دستور .B directory را ببینید). .TP .BI \-machine-readable چاپ اطلاعات در قالبی مناسب‌تر برای ماشین‌ها به‌جای کاربران انسانی، در صورت امکان. برای مثال، هنگام توصیف مکانی در برنامه، مانند چاپ ردگیری به عقب (backtrace)، شمارندهٔ برنامه (program counter) و آفست نویسه در فایل را به‌جای نام فایل، شماره خط و آفست نویسه در آن خط چاپ می‌کند. .TP .BI \-s " socket" استفاده از .I socket برای برقراری ارتباط با برنامهٔ تحت اشکال‌زدایی. برای دیدن ساختار و قالب .IR socket ، توضیحات دستور .B set\ socket در .I "The\ OCaml\ user's\ manual" را ببینید. .TP .B \-version چاپ رشتهٔ نسخه و خروج. .TP .B \-vnum چاپ شماره نسخهٔ کوتاه و خروج. .TP .BR \-help " یا " \-\-help نمایش خلاصهٔ کوتاهی از نحوهٔ استفاده و خروج. .SH "فایل مقداردهی اولیه (INITIALIZATION FILE)" هنگامی که .BR ocamldebug (1) فراخوانی می‌شود، پیش از واگذاری کنترل به کاربر، دستورها را از یک فایل مقداردهی اولیه می‌خواند. فایل پیش‌فرض در صورت وجود، .B .ocamldebug در دایرکتوری فعلی است، در غیر این صورت .B .ocamldebug در دایرکتوری خانگی کاربر خواهد بود. توجه داشته باشید که می‌توانید از دستور .B source file نیز برای خواندن دستورها از یک فایل استفاده کنید. .SH "همچنین ببینید (SEE ALSO)" .BR ocamlc (1). .br .IR The\ OCaml\ user's\ manual ، فصل «The debugger». .SH "نویسندگان (AUTHORS)" این صفحهٔ راهنما توسط Sven LUTHER برای سیستم گنو/لینوکس دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).