ইমাস লিস্প রেফারেন্স ম্যানুয়ালের পরিশিষ্ট ডি 7- তে কয়েকটি মন্তব্য টিপের উল্লেখ রয়েছে:
- একক সেমিকোলনগুলি
;
ইনলাইন মন্তব্যের জন্য ব্যবহার করা উচিত। - ডাবল সেমিকোলন (
;;
) লাইন মন্তব্যের জন্য ব্যবহার করা উচিত। - ট্রিপল সেমিকোলন (
;;;
) "মন্তব্যগুলির জন্য ব্যবহার করা উচিত যা আউটলাইন মাইনর মোডের শিরোনাম হিসাবে বিবেচনা করা উচিত"। ;;;;
কোনও প্রোগ্রামের প্রধান অংশগুলির শিরোনামের জন্য চতুর্থাংশ সেমিকোলনগুলি ব্যবহার করা উচিত।
একক এবং ডাবল সেমিকোলন ব্যবহারের ঘটনাগুলি পরিষ্কার, তবে ট্রিপল এবং চতুর্মুখী সেমিকোলনের মধ্যে তীব্র বর্ণনামূলক বলে মনে হয় না।
বিশেষত, ইমামস প্যাকেজগুলির জন্য সরবরাহিত স্ট্যান্ডার্ড ডকুমেন্টেশনগুলি auto-insert
ট্রিপল সেমিকোলন ব্যবহার করে, কখনও কখনও চতুর্মুখী সেমিকোলনগুলি এমনকি ফাইলের নাম এবং প্রধান বিভাগগুলির মতো সর্বোচ্চ স্তরের শিরোনামগুলির জন্যও ব্যবহার করে। নীচে উদাহরণ দেখুন:
;;; test.el --- A test file. -*- lexical-binding: t; -*-
;; Copyright (C) 2016
;; Author: John Smith
;; Keywords:
;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;; This program 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 for more details.
;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
;;
;;; Code:
(provide 'test)
;;; test.el ends here
ট্রিপল এবং চতুর্মুখী সেমিকোলনের জন্য সেরা অনুশীলনগুলি কী কী?
হালনাগাদ
স্টিফানের উত্তরের জন্য ধন্যবাদ , আমি একটি বাগ রিপোর্ট দায়ের করেছি এবং নিম্নলিখিত পরামর্শটি দিয়েছি:
আমি প্রস্তাব দিচ্ছি যে তিনটি সেমিকোলনের বর্ণনাকে এতে পরিবর্তন করা হবে:
Comments that start with three semicolons, ‘;;;’, are considered top-level headings by Outline minor mode. Four or more semicolons can be used as subheadings in hierarchical fashion. E.g. ;;; Main heading ;;;; Sub heading ;;;;; Sub sub heading ;;;; Another sub heading ;;; Next main heading These comments should be used to break Emacs Lisp code into sections.
ইমাস ম্যানুয়ালটিতে "আউটলাইন মাইনর মোড" এর লিঙ্কটি কার্যকর হবে: https://www.gnu.org/software/emacs/manual/html_node/emacs/Outline-Mode.html
চারটি সেমিকোলনের জন্য বিভাগটি এলিডযুক্ত করা যেতে পারে।
grep -r '^;;;; ' lisp
অনুপ্রেরণার জন্য ইম্যাক্স উত্সগুলি ( ) দেখুন।