.\"
.\" $Id: root-config.1,v 1.4 2005/03/21 21:42:21 rdm Exp $
.\"
.TH ROOT-CONFIG 1 "Version 3" "ROOT"
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other params are allowed: see man(7), man(1)
.SH "نام (NAME)"
root-config \- ابزار ROOT برای Makefileهای شما
.SH "خلاصه دستور (SYNOPSIS)"
.B root-config
.I "[گزینه‌ها]"
.SH "توضیحات (DESCRIPTION)"
دستور \fIroot-config\fP ابزاری است که برای پیکربندی و تعیین پرچم‌های کامپایلر و پیونددهنده که باید برای کامپایل و پیوند برنامه‌های استفاده‌کننده از \fIROOT\fP به کار روند، استفاده می‌شود.
.RS 
.nf 

CPPFLAGS  += $(shell root-config \-\-cflags)
LDLIBS    += $(shell root-config \-\-libs)
LDFLAGS   += $(shell root-config \-\-ldflags)

%Cint.cxx:Include.h LinkDef.h
        rootcint \-f $@ \-c $^ 

.fi
.RE
را در Makefile خود قرار دهید تا از قوانین توکار GNU make استفاده کنید. برای رابط‌های گرافیکی (GUI)، \fI\-\-libs\fR را با \fI\-\-glibs\fR جایگزین کنید.
.PP
همچنین ممکن است فایل ماکروهای \fIautomake\fR(1)، \fIautoconf\fR(1) و \fIlibtool\fR(1) به مسیر \fI/usr/share/aclocal/root.m4\fR برای شما مفید باشد. اگر این فایل ماکرو در جایی که \fIaclocal\fR بتواند آن را بیابد نصب نشده است، محتویات آن را در فایل محلی \fIacinclude.m4\fR خود کپی کنید. در دایرکتوری‌هایی که از کتابخانه‌های \fBROOT\fR استفاده می‌کنید، موارد زیر را در فایل \fIMakefile.am\fR خود قرار دهید:
.RS 
.nf 

lib_LTLIBRARIES         = libFoo.la
pkginclude_HEADERS      = Foo.h
noinst_HEADERS          = FooCint.h
libFoo_la_SOURCES       = Foo.cxx FooCint.cxx   
libFoo_la_LDFLAGS       = \-version-info 1:0 \-R @ROOTLIBDIR@
libFoo_la_LDADD         = \-lCore \-lCint @ROOTAUXLIBS@

BUILT_SOURCES           = FooCint.cxx FooCint.h 

AM_CPPFLAGS             = \-I@ROOTINCDIR@
AM_LDFLAGS              = \-L@ROOTLIBDIR@
CLEANFILES              = *Cint.cxx *Cint.h *~ core 

%Cint.cxx %Cint.h:Include.h LinkDef.h
        @ROOTCINT@ \-f $*Cint.cxx -c $(INCLUDES) $(AM_CPPFLAGS) $^  

.fi
.RE
که در آن باید \fBFoo\fR را با مقدار دلخواه جایگزین کرده و فایل‌های منبع مناسب را در متغیر \fB_SOURCES\fR فهرست کنید. در فایل \fIconfigure.in\fR خود، موارد زیر را قرار دهید:
.RS
.nf

AC_PROG_CC
AC_PROG_CXX
ROOT_PATH
AM_PROG_LIBTOOL

.fi
.RE
به همراه هر ماکروی دیگری که ممکن است نیاز داشته باشید.
.PP
توجه داشته باشید که ماکروی \fBROOT_PATH\fR سه آرگومان اختیاری می‌پذیرد: حداقل نسخهٔ \fBROOT\fR برای استفاده، اقدام در صورت پیدا شدن \fBROOT\fR، و اقدام در صورت پیدا نشدن \fBROOT\fR. چند مثال عبارتند از:
.RS
.nf

ROOT_PATH(3.03/05, , AC_MSG_ERROR(Your ROOT version is too old))
ROOT_PATH(, AC_DEFUN(HAVE_ROOT))

.fi
.RE
برای مثال، اگر می‌خواهید بخشی از درخت کد منبع خود را به صورت مشروط بر اساس حضور یا عدم حضور \fBROOT\fR کامپایل کنید، می‌توانید در فایل \fIconfigure.in\fR خود قرار دهید:
.RS
.nf

ROOT_PATH(,
[
  AC_DEFUN(HAVE_ROOT)
  have_root=yes  
])
AM_CONDITIONAL(GOT_ROOT, test "x$have_root" = "xyes")

.fi
.RE
و سپس در یک فایل \fIMakefile.am\fR:
.RS
.nf

EXTRA_SOURCES		= root_dependent_source.cc
if GOT_ROOT
LIBFOOXTRA              = root_dependent_source.cc
else
LIBFOOXTRA              =
endif

lib_LTLIBRARIES         = libFoo.la
libFoo_la_SOURCES	= Foo.cc  $(LIBFOOXTRA)

.fi
.RE
فهرست کامل متغیرهای جایگزینی عبارتند از:
.TP
.B ROOTCONF
مسیر کامل به \fIroot-config\fR
.TP
.B ROOTEXEC
مسیر کامل به \fIroot\fR
.TP
.B ROOTCINT
مسیر کامل به \fIrootcint\fR
.TP
.B ROOTLIBDIR
محل قرارگیری کتابخانه‌های \fBROOT\fR
.TP
.B ROOTINCDIR
محل قرارگیری هدرهای \fBROOT\fR
.TP
.B ROOTCFLAGS
پرچم‌های اضافی کامپایلر
.TP
.B ROOTLIBS
کتابخانه‌های پایه‌ای \fBROOT\fR
.TP
.B ROOTGLIBS
کتابخانه‌های پایه‌ای و رابط گرافیکی (GUI) \fBROOT\fR
.TP
.B ROOTAUXLIBS
کتابخانه‌های کمکی و پرچم‌های پیونددهنده برای \fBROOT\fR
.TP
.B ROOTAUXCFLAGS
پرچم‌های کمکی کامپایلر
.TP
.B ROOTRPATH
مشابه \fBROOTLIBDIR\fR
.SH "گزینه‌ها (OPTIONS)"
.TP 
.B \-\-help
نمایش فهرستی کوتاه از گزینه‌های موجود و خروج.
.TP
.B \-\-version 
گزارش شماره نسخهٔ \fBROOT\fR نصب‌شده و خروج.
.TP
.BI \-\-prefix =<prefix>
اگر آرگومانی داده نشود، محل نصب \fBROOT\fR را گزارش می‌کند. با دادن آرگومان به صورت =\fI<prefix>\fR، پایهٔ گزینه‌های بعدی را روی \fI<prefix>\fR تنظیم می‌کند. اگر \fB\\-\-exec-prefix\fR همراه با یک آرگومان ارسال شود، بر آرگومان داده‌شده به \fB\\-\-prefix\fR برای مسیر کتابخانه اولویت خواهد داشت.
.TP
.BI \-\-exec-prefix =<prefix>
اگر هیچ آرگومانی داده نشود، محل نصب کتابخانه‌ها را گزارش می‌دهد. در صورت ارائهٔ آرگومان، از آن به عنوان دایرکتوری پایهٔ نصب کتابخانه‌ها استفاده می‌شود. این گزینه بر مسیر include تأثیری ندارد.
.TP
.B \-\-libdir
چاپ دایرکتوری محل نصب کتابخانه‌های ROOT.
.TP
.B \-\-incdir
چاپ دایرکتوری محل نصب هدرهای ROOT.
.TP
.B \-\-libs
تولید خطی مناسب برای پیوند دادن یک برنامه با کتابخانه‌های \fBROOT\fR. هیچ کتابخانهٔ گرافیکی گنجانده نمی‌شود.
.TP
.B \-\-glibs
مشابه بالا، اما کتابخانه‌های گرافیکی (GUI) را نیز شامل می‌شود.
.TP
.B \-\-evelibs
مشابه بالا، اما کتابخانه‌های گرافیکی و کتابخانه‌های Eve را نیز شامل می‌شود.
.TP
.B \-\-cflags
تولید خطی مناسب برای کامپایل یک فایل منبع در کنار فایل‌های هدر (اعلان کلاس‌های) \fBROOT\fR.
.TP
.B \-\-new 
قرار دادن کتابخانهٔ \fBlibNew.so\fR در فهرست کتابخانه‌ها. این گزینه \fIباید\fR پیش از گزینه‌های \fB\-\-libs\fR و \fB\-\-glibs\fR مشخص شود.
.TP
.B \-\-nonew 
گزینهٔ سازگاری، کاری انجام نمی‌دهد.
.TP
.B \-\-auxlibs
چاپ کتابخانه‌های کمکی و/یا پرچم‌های پیونددهندهٔ سیستم.
.TP
.B \-\-noauxlibs
عدم چاپ کتابخانه‌های کمکی و/یا پرچم‌های پیونددهندهٔ سیستم در خروجی \fB\-\-libs\fR و \fB\-\-glibs\fR.
.B \-\-auxcflags
چاپ پرچم‌های کمکی کامپایلر.
.TP
.B \-\-noauxcflags
عدم چاپ پرچم‌های کمکی کامپایلر در خروجی \fB\-\-cflags\fR.
.TP
.B \-\-noldflags
عدم چاپ گزینهٔ پیوند مسیر کتابخانه در خروجی \fB\-\-libs\fR، \fB\-\-evelibs\fR و \fB\-\-glibs\fR.
.TP
.B \-\-ldflags
چاپ پرچم‌های پیونددهندهٔ اضافی (مانند \fB\-m64\fR).
.TP
.B \-\-arch
چاپ معماری (کامپایلر/سیستم‌عامل).
.TP
.B \-\-platform
چاپ بستر اجرایی (سیستم‌عامل).
.TP
.B \-\-bindir
چاپ دایرکتوری باینری نصب root (محل فایل اجرایی root).
.TP
.B \-\-etcdir
چاپ دایرکتوری پیکربندی (محل فایل‌های system.rootrc، نوع MIME، فایل‌های سرکوب valgrind و فایل‌های .desktop).
.TP
.B \-\-config
چاپ آرگومان‌های ارائه‌شده به ./configure در هنگام ساخت root. این آرگومان‌ها در صورتی که root با CMake ساخته شده باشد برای ./configure قابل استفاده نیستند.
.TP
.B \-\-git-revision
چاپ شماره بازبینی git مربوط به ROOT که root از روی آن ساخته شده است.
.TP
.B \-\-has-<feature>
بررسی اینکه آیا <feature> در فرایند ساخت فعال شده است یا خیر.
.TP
.B \-\-features
چاپ فهرستی از تمام ویژگی‌های پشتیبانی‌شده.
.TP
.B \-\-ncpu
چاپ تعداد هسته‌های پردازشی موجود (با احتساب hyperthreading).
.TP
.B \-\-python-version
چاپ نسخهٔ Python استفاده‌شده توسط ROOT.
.TP
.B \-\-cc
چاپ کامپایلر C جایگزین که هنگام ساخت ROOT مشخص شده است.
.TP
.B \-\-cxx
چاپ کامپایلر ++C جایگزین که هنگام ساخت ROOT مشخص شده است.
.TP
.B \-\-f77
چاپ کامپایلر Fortran جایگزین که هنگام ساخت ROOT مشخص شده است.
.TP
.B \-\-ld
چاپ پیونددهندهٔ جایگزین که هنگام ساخت ROOT مشخص شده است.
.SH "همچنین ببینید (SEE ALSO)"
\fIroot\fR(1), \fIroot-cint\fR(1)
.PP
همچنین به صفحات وب \fBROOT\fR مراجعه کنید:
.UR http://root.cern
\fIhttp://root.cern\fR
.UE
.SH "نویسندگان اصلی (ORIGINAL AUTHORS)"
تیم ROOT (به صفحهٔ وب بالا مراجعه کنید):
.RS
\fBRene Brun\fR و \fBFons Rademakers\fR
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
این کتابخانه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی جامع همگانی محدودتر گنو» (GNU Lesser General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ 2.1 مجوز و چه (به انتخاب خودتان) هر نسخهٔ متأخرتری، بازتوزیع کرده و/یا تغییر دهید.
.P
این کتابخانه با این امید که مفید واقع شود توزیع شده است، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی جامع همگانی محدودتر گنو» مراجعه کنید.
.P
شما باید به همراه این کتابخانه نسخه‌ای از «مجوز عمومی جامع همگانی محدودتر گنو» را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر نامه بنویسید:
Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
.SH "نویسندگان (AUTHORS)"
این صفحهٔ راهنما توسط Christian Holm Christensen <cholm@nbi.dk> برای سیستم گنو/لینوکس دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).
.\"
.\" EOF
.\"