نام (NAME)

deweb - پاک‌سازی دستورهای C و CWEB از کدهای منبع CWEB

خلاصه دستور (SYNOPSIS)

deweb [ file1 file2 ... ]

توضیحات (DESCRIPTION)

برنامه deweb تمامی دستورهای C و CWEB را از کد منبع CWEB فیلتر و حذف می‌کند. با این کار تنها کد LaTeX باقی می‌ماند. سپس این کد پالایش‌شده می‌تواند به یک بررسی‌کننده نحو مناسب برای LaTeX مانند ChkTeX و lacheck یا غلط‌یاب‌های املایی مانند ispell تحویل داده شود.

ابزار chkweb که در توزیع ChkTeX گنجانده شده است دقیقاً همین کار را انجام می‌دهد؛ نوشتن اسکریپت‌های مشابه نیز بسیار ساده خواهد بود.

هنگامی که deweb کد C را از سورس CWEB شما جدا می‌کند، تلاش می‌کند تا شکست‌های خط را حفظ کند. این بدان معناست که گزارش‌های خطای ارائه‌شده توسط <ابزار دلخواه شما> از نظر شماره خطوط صحیح خواهند بود. در بیشتر موارد، موقعیت ستون نیز درست خواهد بود. این امر یافتن خطاها را در منبع LaTeX بسیار ساده می‌کند (برخلاف خروجی cweave، که سر درآوردن از آن واقعاً دشوار است).

برنامه deweb فهرستی از نام‌های فایل را در خط آرگومان می‌پذیرد و خروجی خود را به stdout می‌فرستد. اگر نام فایلی داده نشود، از stdin می‌خواند و مانند یک فیلتر عمل می‌کند. در حال حاضر هیچ گزینه‌ای پذیرفته نمی‌شود.

کاربران حرفه‌ای ممکن است تلاش کنند تا خروجی deweb را مستقیماً به LaTeX هدایت (pipe) کنند؛ از نظر تئوری، این کار باید جواب دهد. این امر اشکال‌زدایی کد LaTeX را به‌طرز چشمگیری تسهیل می‌کند، زیرا زمانی که LaTeX به نحو نادرست ایراد می‌گیرد، می‌توانید خط دارای خطا را بسیار ساده‌تر پیدا کنید. با این حال، انتظار نداشته باشید که خروجی شباهت چندانی به نسخه نهایی داشته باشد.

برنامه deweb اکنون باید تمام آپ‌کدهای معتبر CWEB را بشناسد. اگر درباره عدم شناسایی یک آپ‌کد درست خطایی داد، لطفاً نویسنده را مطلع سازید.

توزیع (DISTRIBUTION)

کپی‌رایت (C) ۱۹۹۶ Jens T. Berger Thielemann

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط GNU General Public License همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، دوباره توزیع نموده و/یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت تجاری یا تناسب برای یک هدف خاص. برای جزئیات بیشتر به GNU General Public License مراجعه کنید.

شما باید به همراه این برنامه نسخه‌ای از GNU General Public License را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر مکاتبه کنید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

محیط (ENVIRONMENT)

هیچ متغیر محیطی استفاده نمی‌شود.

فایل‌ها (FILES)

هیچ.

نویسندگان (AUTHORS)

Jens T. Berger Thielemann, <jensthi@ifi.uio.no>

همچنین ببینید (SEE ALSO)

cweave(1), perl(1), chktex, lacheck(1), ispell(1)

گزارش باگ‌ها (BUGS)

تحت نسخه‌های Perl قبل از perl v5 حتی کامپایل نمی‌شود. متأسفانه این بدان معناست که ما حتی نمی‌توانیم علت خرابی را به کاربر اطلاع دهیم؛ Perl تنها خطایی مبنی بر عدم امکان کامپایل regexps نمایش خواهد داد.

این برنامه به جای پردازش خط به خط، تلاش خواهد کرد کل فایل ورودی را به یکباره بخواند.