ইমাস লিস্প মন্তব্য সম্মেলন


17

ইমাস লিস্প রেফারেন্স ম্যানুয়ালের পরিশিষ্ট ডি 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অনুপ্রেরণার জন্য ইম্যাক্স উত্সগুলি ( ) দেখুন।
এসডিএস

@ এসএসএস যা কয়েকটি অ-মানক অ্যাপ্লিকেশনকে ;;;;; ক্যানোনিকাল উত্সগুলিতে;)
টাইলার

এটাই আমি বোঝাতে চেয়েছি - এই 4 টি অর্ধিকোলনের প্রস্তাবটি খুব বেশি গুরুত্ব সহকারে নেওয়া যাবে না, ওটিওএইচ, ফাইল টাইমস্ট্যাম্পের দিকেও নজর দেওয়া উচিত - এই অ-মানক জিনিসগুলি অপ্রচলিত হতে পারে।
এসডিএস

উত্তর:


13

প্রকৃতপক্ষে, 3-এবং আরও বেশি আধা-কলোনগুলি শিরোনামের জন্য দাঁড়ায়, যেখানে শিরোনামের নীড়কে আরও গভীর করে রাখলে আরও আধা-কোলন থাকে। সুতরাং এটি দেখতে হবে

;;; Main heading
;;;; Sub heading
;;;;; Sub sub heading
;;;; Another sub heading
;;; Next main heading

এটি সাধারণ অনুশীলন বলে মনে হয়, তবে প্রশ্নের সাথে যুক্ত এলিস্প ম্যানুয়ালটিতে তালিকাভুক্ত সম্মেলনগুলির থেকে পৃথক। ম্যানুয়ালটিতে কি এটি একটি বাগ?
টাইলার

3
এটি কেবল অনুশীলনের প্রশ্ন নয়। এইভাবে emacs-lisp-modeকনফিগার করে outline-minor-mode। আমি আপনাকে একটি ডকুমেন্টেশন বাগ হিসাবে এটি রিপোর্ট করার পরামর্শ দিচ্ছি (আমার কাছে মনে হয় ডকটি ভুলের চেয়ে অস্পষ্ট তবে শেষ ফলাফলটি একই))
স্টিফান

আমি একটি বাগ রিপোর্ট প্রেরণ করেছি, এবং ডকুমেন্টেশনটি অন্য কোনও কিছুর বদলে দেওয়ার জন্য প্রস্তাবনা দিয়েছি। আমি দেখতে পাচ্ছি যে আমি ম্যানুয়ালটির জন্য টেক্সইনফোর উত্সটি পেতে পারি; এমন কোনও ভাণ্ডার রয়েছে যার বিরুদ্ধে আমি ক্লোন করতে পারি এবং এর বিপরীতে একটি অনুরোধ করতে পারি?
তিয়ানসিয়াং জিয়াং

@ তিয়ানজিয়াংজিওনগ: অবশ্যই, ডকটি ইমাক্সের উত্স কোডের একটি অংশ, তাই আপনি ক্লোন করে git://git.sv.gnu.org/emacs.gitতারপরে একটি প্যাচ পাঠাতে পারেন M-x report-emacs-bug
স্টিফান

রেফারেন্সের জন্য, এখানে কমন লিস্প কনভেনশন রয়েছে । যদি ইমাস লিস্প সত্যিই কোনও শিরোনামের জন্য 3 টি সেমিকোলন ব্যবহার করে তবে 4 টি সেমিকোলন কম বিশিষ্ট শিরোনামের জন্য ব্যবহার করে তবে এটি সিএল এবং অন্যান্য লিপসে যা দেখেছি তার অযৌক্তিক এবং বিপরীত বলে মনে হয়। Org- মোড স্টাইল শিরোনামগুলির জন্য এটি কেবল আরও ভাল ফিট যাতে তারা এ্যালসপির জন্যও এটির সাথে চলে।
ল্যাসি
আমাদের সাইট ব্যবহার করে, আপনি স্বীকার করেছেন যে আপনি আমাদের কুকি নীতি এবং গোপনীয়তা নীতিটি পড়েছেন এবং বুঝতে পেরেছেন ।
Licensed under cc by-sa 3.0 with attribution required.