'\" t
.\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\"     Arch: generic
.\"     Software: JDK 8
.\"     Date: 21 November 2013
.\"     SectDesc: Scripting Tools
.\"     Title: jrunscript.1
.\"
.if n .pl 99999
.TH jrunscript 1 "21 November 2013" "JDK 8" "Scripting Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------

.SH "نام (NAME)"
jrunscript \- اجرای یک پوسته اسکریپت‌نویسی خط فرمان با پشتیبانی از حالت‌های تعاملی و دسته‌ای (دستور آزمایشی و پشتیبانی‌نشده)
.SH "خلاصه دستور (SYNOPSIS)"
.sp     
.nf     

\fBjrunscript\fR [\fIoptions\fR] [\fIarguments\fR]
.fi     
.sp     
.TP     
\fIoptions\fR
گزینه‌های خط فرمان\&. بخش گزینه‌ها را ببینید\&.
.TP     
\fIarguments\fR
آرگومان‌ها، در صورت استفاده، بلافاصله پس از گزینه‌ها یا نام دستور قرار می‌گیرند\&. بخش آرگومان‌ها را ببینید\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3jrunscript\fR یک پوسته اسکریپت‌نویسی خط فرمان و مستقل از زبان است\&. دستور \f3jrunscript\fR از هر دو حالت اجرای تعاملی (read-eval-print) و دسته‌ای (گزینه \f3-f\fR) اسکریپت پشتیبانی می‌کند\&. به‌طور پیش‌فرض، جاوااسکریپت زبان مورداستفاده است، اما با گزینه \f3-l\fR می‌توان زبان متفاوتی را مشخص کرد\&. دستور \f3jrunscript\fR با استفاده از ارتباط میان جاوا و زبان اسکریپت‌نویسی، از سبک برنامه‌نویسی اکتشافی پشتیبانی می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.TP
-classpath \fIpath\fR
.br
مشخص می‌کند که فایل‌های کلاس مورد نیاز اسکریپت در کجا قرار دارند\&.
.TP
-cp \fIpath\fR
.br
همانند \f3-classpath\fR \fIpath\fR است\&.
.TP
-D\fIname\fR=\fIvalue\fR
.br
یک ویژگی سیستمی جاوا را تنظیم می‌کند\&.
.TP
-J\fIflag\fR
.br
فلگ \f3flag\fR را مستقیماً به ماشین مجازی جاوا (JVM) که دستور \f3jrunscript\fR در آن در حال اجراست ارسال می‌کند\&.
.TP
-I \fIlanguage\fR
.br
از زبان اسکریپت‌نویسی مشخص‌شده استفاده می‌کند\&. به‌طور پیش‌فرض از جاوااسکریپت استفاده می‌شود\&. برای استفاده از زبان‌های اسکریپت‌نویسی دیگر، باید فایل JAR موتور اسکریپت مربوطه را با گزینه \f3-cp\fR یا \f3-classpath\fR مشخص کنید\&.
.TP
-e \fIscript\fR
.br
اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند\&. از این گزینه می‌توان برای اجرای اسکریپت‌های تک‌خطی که کاملاً در خط فرمان مشخص شده‌اند استفاده کرد\&.
.TP
-encoding \fIencoding\fR
.br
کدگذاری نویسه‌ها را برای خواندن فایل‌های اسکریپت مشخص می‌کند\&.
.TP
-f \fIscript-file\fR
.br
فایل اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند (حالت دسته‌ای)\&.
.TP
-f -
.br
یک اسکریپت را از ورودی استاندارد خوانده و اجرا می‌کند (حالت تعاملی)\&.
.TP
-help
.br
پیام راهنما را نمایش داده و خارج می‌شود\&.
.TP
-?
.br
پیام راهنما را نمایش داده و خارج می‌شود\&.
.TP
-q
.br
تمام موتورهای اسکریپت موجود را فهرست کرده و خارج می‌شود\&.
.SH "آرگومان‌ها (ARGUMENTS)"
اگر آرگومان‌ها مشخص شده باشند و هیچ گزینه‌ای از \f3-e\fR یا \f3-f\fR استفاده نشده باشد، اولین آرگومان فایل اسکریپت خواهد بود و بقیه آرگومان‌ها (در صورت وجود) به اسکریپت ارسال می‌شوند\&. اگر آرگومان‌ها همراه با گزینه \f3-e\fR یا \f3-f\fR مشخص شوند، تمام آرگومان‌ها به اسکریپت ارسال می‌گردند\&. در صورت عدم وجود آرگومان‌ها و گزینه‌های \f3-e\fR و \f3-f\fR، از حالت تعاملی استفاده می‌شود\&. آرگومان‌های اسکریپت از طریق یک متغیر موتور به نام \f3arguments\fR از نوع آرایه \f3String\fR در دسترس اسکریپت هستند\&.
.SH "مثال‌ها (EXAMPLES)"
.SS "اجرای اسکریپت‌های درون‌خطی (EXECUTE INLINE SCRIPTS)"
.sp     
.nf     
\f3jrunscript \-e "print(\&'hello world\&')"\fP
.fi     
.nf     
\f3jrunscript \-e "cat(\&'http://www\&.example\&.com\&')"\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SS "استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت (USE SPECIFIED LANGUAGE AND EVALUATE THE SCRIPT FILE)"
.sp     
.nf     
\f3jrunscript \-l js \-f test\&.js\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SS "حالت تعاملی (INTERACTIVE MODE)"
.sp     
.nf     
\f3jrunscript\fP
.fi     
.nf     
\f3js> print(\&'Hello World\en\&');\fP
.fi     
.nf     
\f3Hello World\fP
.fi     
.nf     
\f3js> 34 + 55\fP
.fi     
.nf     
\f389\&.0\fP
.fi     
.nf     
\f3js> t = new java\&.lang\&.Thread(function() { print(\&'Hello World\en\&'); })\fP
.fi     
.nf     
\f3Thread[Thread\-0,5,main]\fP
.fi     
.nf     
\f3js> t\&.start()\fP
.fi     
.nf     
\f3js> Hello World\fP
.fi     
.nf     
\f3\fP
.fi     
.nf     
\f3js>\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SS "اجرای فایل اسکریپت با آرگومان‌های اسکریپت (RUN SCRIPT FILE WITH SCRIPT ARGUMENTS)"
فایل test\&.js همان فایل اسکریپت است\&. آرگومان‌های \f3arg1\fR، \f3arg2\fR و \f3arg3\fR به اسکریپت ارسال می‌شوند\&. اسکریپت می‌تواند از طریق آرایه arguments به این آرگومان‌ها دسترسی پیدا کند\&.
.sp     
.nf     
\f3jrunscript test\&.js arg1 arg2 arg3\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SH "همچنین ببینید (SEE ALSO)"
اگر از جاوااسکریپت استفاده شود، دستور \f3jrunscript\fR پیش از ارزیابی اسکریپت تعریف‌شده توسط کاربر، توابع و اشیاء پیش‌ساخته معینی را مقداردهی اولیه می‌کند\&. این موارد پیش‌ساخته جاوااسکریپت در JsDoc-Toolkit در نشانی http://code\&.google\&.com/p/jsdoc-toolkit مستند شده‌اند\&.
.RE
.br
'pl 8.5i
'bp