বেশিরভাগ ম্যান পেজগুলিতে কয়েকটি সাধারণ উদাহরণ অন্তর্ভুক্ত না করার কোনও কারণ আছে কি? তারা সাধারণত সমস্ত সম্ভাব্য বিকল্পগুলি ব্যাখ্যা করে, তবে এটি "সাধারণত" কীভাবে ব্যবহৃত হয় তা বুঝতে প্রাথমিকভাবে বুঝতে এটি আরও শক্ত করে তোলে।
man jq
বেশিরভাগ ম্যান পেজগুলিতে কয়েকটি সাধারণ উদাহরণ অন্তর্ভুক্ত না করার কোনও কারণ আছে কি? তারা সাধারণত সমস্ত সম্ভাব্য বিকল্পগুলি ব্যাখ্যা করে, তবে এটি "সাধারণত" কীভাবে ব্যবহৃত হয় তা বুঝতে প্রাথমিকভাবে বুঝতে এটি আরও শক্ত করে তোলে।
man jq
উত্তর:
এই লোক পৃষ্ঠাগুলি উপর নির্ভর করে ... প্রথাগতভাবে, তারা আছে উদাহরণ একটি অধ্যায় অন্তর্ভুক্ত - কিন্তু কিছু কারণে সাধারণত লিনাক্স অধীনে মানুষ পেজ থেকে অনুপস্থিত যে (এবং আমি গনুহ কমান্ড ব্যবহার করে অন্যান্য অনুমান - যা এর মধ্যে সবচেয়ে দিন)। অন্যদিকে সোলারিতে প্রায় প্রতিটি পৃষ্ঠা পৃষ্ঠাতে প্রায়শই বেশ কয়েকটি উদাহরণ সহ উদাহরণ বিভাগ অন্তর্ভুক্ত থাকে।
যদি আমি অনুমান করতে পারি তবে এফএসএফ / জিএনইউ দীর্ঘকাল ধরে man
পৃষ্ঠাগুলির ব্যবহারকে নিরুৎসাহিত করেছে এবং এর পরিবর্তে ব্যবহারকারীদের ডকুমেন্টেশনের জন্য তথ্য ব্যবহার করতে পছন্দ করে। info
পৃষ্ঠাগুলি মানুষ পৃষ্ঠার চেয়ে আরো ব্যাপক হতে থাকে, এবং সাধারণত না উদাহরণ অন্তর্ভুক্ত। info
পৃষ্ঠাগুলি আরও "সাময়িক" - যেমন সম্পর্কিত কমান্ড (যেমন ফাইল সন্ধানের জন্য আদেশ) প্রায়শই একসাথে পাওয়া যায়।
আর একটি কারণ হতে পারে যে জিএনইউ এবং এর man
পৃষ্ঠাগুলি বিভিন্ন অপারেটিং সিস্টেমে ব্যবহৃত হয় যা একে অপরের থেকে পৃথক হতে পারে (কেবলমাত্র বিভিন্ন লিনাক্স ডিস্ট্রোসের মধ্যে প্রচুর পার্থক্য থাকার পরে)। উদ্দেশ্য হতে পারে যে প্রকাশক নির্দিষ্ট ওএস / ডিস্ট্রো সম্পর্কিত প্রাসঙ্গিক উদাহরণ যুক্ত করেছিলেন - যা সম্ভবত খুব কমই করা হয়।
আমি আরও যোগ করব যে man
পৃষ্ঠাগুলি কখনই "শিক্ষানবিশদের শেখানোর" উদ্দেশ্যে করা হয়নি। ইউএনআইএক্স কম্পিউটার বিশেষজ্ঞরা তৈরি করেছিলেন (পুরাতন শব্দ "হ্যাকারস") এবং এটি কম্পিউটার বিশেষজ্ঞরা ব্যবহার করার ইচ্ছা করেছিলেন। ম্যান পেজগুলি কোনও নবজাতককে শেখানোর জন্য তৈরি করা হয়নি, তবে দ্রুত এমন একজন কম্পিউটার বিশেষজ্ঞকে সহায়তা করার জন্য, যাকে কিছু অস্পষ্ট বিকল্প বা অদ্ভুত ফাইল ফর্ম্যাটের জন্য একটি অনুস্মারক প্রয়োজন - এবং এটি কীভাবে কোনও পৃষ্ঠা পৃষ্ঠা বিভাগ করা হয় তা প্রতিফলিত হয়।
man
পৃষ্ঠাগুলি এইভাবে উদ্দেশ্যে করা হয়
man
পৃষ্ঠাগুলির উল্লেখ - যেমন। কনফিগার ফাইল এবং সম্পর্কিত / অনুরূপ আদেশের বিন্যাসের জন্য।এটি বলেছিল, আমি আপনার সাথে অনেকটাই একমত যে man
পৃষ্ঠাগুলির উদাহরণ থাকা উচিত, যেহেতু তারা ম্যান পৃষ্ঠায় নিজেই ওয়াডিংয়ের চেয়ে ব্যবহারের আরও ভাল ব্যাখ্যা করতে পারে। খুব খারাপ উদাহরণগুলি সাধারণত লিনাক্স man
পৃষ্ঠাগুলিতে পাওয়া যায় না ...
সোলারিস ম্যান পৃষ্ঠার উদাহরণ অংশের নমুনা - zfs (1M):
(...) উদাহরণ উদাহরণ 1 একটি জেডএফএস ফাইল সিস্টেমের স্তরক্রম তৈরি করা নিম্নলিখিত কমান্ডগুলি পুল / হোম নামে একটি ফাইল সিস্টেম তৈরি করে এবং পুল / হোম / বব নামে একটি ফাইল সিস্টেম। মাউন্ট পয়েন্ট / এক্সপোর্ট / হোম প্যারেন্ট ফাইল সিস্টেমের জন্য সেট করা হয় এবং হয় চাইল্ড ফাইল সিস্টেম দ্বারা স্বয়ংক্রিয়ভাবে উত্তরাধিকার সূত্রে প্রাপ্ত। # zfs পুল / হোম তৈরি করে # zfs মাউন্টপয়েন্ট = / এক্সপোর্ট / হোম পুল / হোম সেট করে # zfs পুল / হোম / বব তৈরি করে উদাহরণ 2 একটি জেডএফএস স্ন্যাপশট তৈরি করা নিম্নলিখিত কমান্ডটি গতকাল একটি স্ন্যাপশট তৈরি করেছে। এই স্ন্যাপশটটি .zfs / স্ন্যাপশটের চাহিদা অনুসারে মাউন্ট করা হয় পুল / হোম / বব ফাইল সিস্টেমের মূলের ডিরেক্টরি। গতকাল # জেডএফএস স্ন্যাপশট পুল / হোম / বব @ উদাহরণ 3 একাধিক স্ন্যাপশট তৈরি এবং ধ্বংস করা নিম্নলিখিত কমান্ডটি গতকাল স্নাপশট তৈরি করেছে পুল / হোম এবং এর সমস্ত বংশধর ফাইল সিস্টেম। প্রতি স্ন্যাপশট .zfs / স্ন্যাপশট ডিরেক্টরিতে চাহিদার উপর মাউন্ট করা হয় এর ফাইল সিস্টেমের মূলে। দ্বিতীয় কমান্ড ধ্বংস করে দেয় সদ্য নির্মিত স্ন্যাপশট # zfs স্ন্যাপশট -আর পুল / হোম @ গতকাল # জেডএফএস গতকাল -আর পুল / হোম নষ্ট করে সুনোস 5.11 শেষ পরিবর্তন: 23 জুলাই 51 51 51 সিস্টেম অ্যাডমিনিস্ট্রেশন কমান্ড zfs (1M) উদাহরণ 4 ফাইল সিস্টেম সংক্ষেপণ অক্ষম করা এবং সক্ষম করা নিম্নলিখিত কমান্ডটি এর জন্য সংকোচনের বৈশিষ্ট্যটি অক্ষম করে (...)
এই বিশেষ ম্যান পেজটিতে 16 টি (!) উদাহরণ রয়েছে ... সোলারিস থেকে কুডোস!
(এবং আমি স্বীকার করব যে আমি নিজেই এই কমান্ডের জন্য পুরো ম্যান পৃষ্ঠাটি পড়ার পরিবর্তে এই উদাহরণগুলি অনুসরণ করেছি ...)
zfs
) বেশ প্রাকৃতিকভাবে ডিজাইন করা হয়েছে। উদাহরণস্বরূপ, zfs destroy pool/filesystem
ব্যবহারের 90% ক্ষেত্রে মৌলিক ব্যবহার এবং জরিমানা। মত সংক্ষিপ্ত অপশন -r
জন্য recursive
আরো বিশেষ এবং ব্যবহারের পূর্বে আলোচনা প্রয়োজন, কারণ তারা অনিচ্ছাকৃত পার্শ্ব প্রতিক্রিয়া থাকতে পারে।
আমি মনে করি না এর একটি ভাল উত্তর আছে। এটা একটা সংস্কৃতির জিনিস। কিছু ম্যান পেজের উদাহরণ ব্যবহার রয়েছে। যেমন man rsync
। ম্যান পেজ লেখকের কাছে লিখিতভাবে এবং তাকে বা তার নমুনা ব্যবহারের জন্য কিছু বলার বা কিছু নমুনা ব্যবহারের উদাহরণ নিজেই উপস্থাপনের মাধ্যমে তাকে সংস্কৃতি পরিবর্তনের চেষ্টা করতে পারেন। আপনি যদি কোনও মুক্ত সফ্টওয়্যার লেখককে একটি প্যাচ, বিশেষত একটি ডকুমেন্টেশন প্যাচ সরবরাহ করেন তবে সাধারণ অনুরোধের চেয়ে কাঙ্ক্ষিত ফলাফল অর্জনের সম্ভাবনা প্রায় দশ হাজার গুণ বেশি।
এটা নির্ভর করে:
কিছু প্রোগ্রামের জন্য, বিকাশকারীরা নমুনা প্রোগ্রাম বা স্ক্রিপ্ট সরবরাহ করতে পছন্দ করেন যা কোনও প্রদত্ত প্রোগ্রাম (বা গ্রন্থাগার) কীভাবে ব্যবহার করতে হয় তা দেখায়। আবার কোনও সমস্যা সমাধানের জন্য এটি করা হয়: প্রোগ্রামটি পরীক্ষা করা সহজ করে তোলে।
কয়েকটি উদাহরণ ব্যবহারকারীদের বাগ রিপোর্টের উপর ভিত্তি করে হতে পারে এবং যখন ম্যানুয়ালটিতে সংক্ষিপ্ত স্থান পায়। দৈর্ঘ্যের উদাহরণগুলি ম্যানুয়ালগুলিতে খুব কমই সরবরাহ করা হয় এবং সংক্ষিপ্ত উদাহরণগুলির মধ্যে এমন সমস্যা রয়েছে যে তারা তুচ্ছ, পুনরাবৃত্তিযোগ্য এবং ব্যবহারকারীর পক্ষে কোনও প্রোগ্রামের কাজ করার মতো সুসংগঠিত বিবরণের মতো যথাযথ অন্তর্দৃষ্টি প্রদান করে না।
আপনি যদি ম্যান পেজগুলির বিকল্প খুঁজছেন, আপনি সর্বদা ব্রো পৃষ্ঠাগুলি চেষ্টা করতে পারেন , যা কেবলমাত্র একটি আদেশের বিভিন্ন উদাহরণ দেখায়, যা আপনি সম্প্রদায়-জমা দেওয়া উদাহরণগুলির তালিকার মধ্যে ভোট দিতে পারেন। উদাহরণস্বরূপ, আদেশটি bro tar
আপনাকে দেবে: