كتابة التعليمات البرمجية (الكود) :
سوف نكتب برنامج لوميض ليد . الكود بكامله ذات نص مميز بألوان محددة .
1- الجزء الأول : (بلوك) العنوان والكاتب Title & Author Block :
نبدأ بكتابة بلوك العنوان حتى يتعرف أى شخص على من قام بإنشائه .
كود:
-- ------------------------------------------------------
-- Title: Blink-a-led of the Microchip pic16f877a
--
-- Author: Rob Hamerling, Copyright (c) 2008..2009, all rights reserved.
--
-- Adapted-by:
--
-- Compiler: 2.4l
--
-- This file is part of jallib (http://jallib.googlecode.com)
-- Released under the BSD license (http://www.opensource.org/licenses/bsdlicense.php)
--
-- Description:
-- Sample blink-a-led program for Microchip PIC16f877a.
--
-- Sources:
--
-- Notes:
-- - File creation date/time: 14 Oct 2009 20:24:20.
--
-- ------------------------------------------------------
يمكنك رؤية "شرطتان "-" للإعلان عن "تعليق" comment حتى يتم تجاهله من قبل المترجم . أيضا يمكن استخدام الفاصلة المنقوطة “;” للتعليقات .
ونحن نمضى , سوف نقوم بالتعليق على طول البرنامج حتى يصبح من السهل علينا قراءة برنامجنا .
تذكر :
التعليقات Comments :
الأسطر التى تتضمن تعليقات يسبقها "شرطتين" أو "فاصلة منقوطة" . يجب عمل ذلك فى كل سطر حيث لا يوجد تعبيير لمجموعة من التعليقات "بلوك تعليقات".
الصيغة :
;this is a comment
-- and this too
يستخدم سطر التعليق لتوضيح السبب من البرنامج أو سبب فعل الأشياء وطريقة عملها . التعليق مفيد جدا فى المستقبل كمرجع أو عندما تريد مشاركة الأخرين بالبرامج .
من المفضل عمليا بيان إصدار لغة JAL فى أو سطر بالبرنامج وهذا يزيل الكثير من التساؤلات .
التعليقات الجيدة تكون حول سبب استخدام عبارة ما . إذا استخدمت مكتبة يجب أن تستخدم أسطر تعليقات لشرح تفاصيل سبب وطريقة استخدام المكتبة . المكتبات بدون هذه التعليقات تكون غير مفيدة على الإطلاق .