মানব পৃষ্ঠাগুলির উদাহরণ নেই কেন?


52

বেশিরভাগ ম্যান পেজগুলিতে কয়েকটি সাধারণ উদাহরণ অন্তর্ভুক্ত না করার কোনও কারণ আছে কি? তারা সাধারণত সমস্ত সম্ভাব্য বিকল্পগুলি ব্যাখ্যা করে, তবে এটি "সাধারণত" কীভাবে ব্যবহৃত হয় তা বুঝতে প্রাথমিকভাবে বুঝতে এটি আরও শক্ত করে তোলে।


1
আমার অনুমান যে তারা সিআর থেকে মুক্তি পাওয়ার মতো মূল্যবান ডিস্কের স্থান সংরক্ষণ করতে চেয়েছিল। Cf. বিকেট , ওয়াট , পৃষ্ঠা ৮: " বলার পরে আধিক্য প্রতিচ্ছবি সর্বনাম এড়িয়ে অনেক মূল্যবান জায়গা সংরক্ষণ করা হয়েছে [...] "
পিটার - মনিকা পুনরায়

3
এই সমস্যার জন্য একটি চেষ্টা করার চেষ্টা করা হচ্ছে tldr-pages.github.io , যদিও অফলাইনে অ্যাক্সেসের জন্য তারা কেন সব কিছু সামনে ডাউনলোড করতে সহজ করে তোলে তা আমি দেখতে পাই না।
নাথান লং

উত্তর:


49

এই লোক পৃষ্ঠাগুলি উপর নির্ভর করে ... প্রথাগতভাবে, তারা আছে উদাহরণ একটি অধ্যায় অন্তর্ভুক্ত - কিন্তু কিছু কারণে সাধারণত লিনাক্স অধীনে মানুষ পেজ থেকে অনুপস্থিত যে (এবং আমি গনুহ কমান্ড ব্যবহার করে অন্যান্য অনুমান - যা এর মধ্যে সবচেয়ে দিন)। অন্যদিকে সোলারিতে প্রায় প্রতিটি পৃষ্ঠা পৃষ্ঠাতে প্রায়শই বেশ কয়েকটি উদাহরণ সহ উদাহরণ বিভাগ অন্তর্ভুক্ত থাকে।

যদি আমি অনুমান করতে পারি তবে এফএসএফ / জিএনইউ দীর্ঘকাল ধরে 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 টি (!) উদাহরণ রয়েছে ... সোলারিস থেকে কুডোস!
(এবং আমি স্বীকার করব যে আমি নিজেই এই কমান্ডের জন্য পুরো ম্যান পৃষ্ঠাটি পড়ার পরিবর্তে এই উদাহরণগুলি অনুসরণ করেছি ...)


2
সেই শেষ বাক্যটি ম্যানুয়ালগুলিতে উদাহরণ সহ একটি সমস্যা তুলে ধরে । একজন সেই উদাহরণ গ্রহণ করে যা সরঞ্জামটির নির্দিষ্ট প্রয়োগের প্রভাবগুলি পুরোপুরি না বুঝে নিজের প্রয়োজনের সাথে সবচেয়ে ভাল ফিট করে। এবং পরে, কেউ কেবল "আমি এটি এরকম করেছিলাম" বলতে পারি, তবে আসলে বা কেন এটি বোঝায় তা নয়।
কুসালানন্দ

6
@Kusalananda আমার প্রতিরক্ষা, আমি আছে বিভিন্ন বিকল্পগুলি সম্পর্কে ও উপ-কমান্ড আমি আসলে থাকেন সম্পর্কে পড়তে প্রয়োজন শুধু পুরো জিনিস (এখনও) -। এটা শুধু আমার ব্যবহারের জন্য প্রাসঙ্গিক না ... অপব্যবহার বিপদের সত্ত্বেও, উদাহরণ না একটি উদ্দেশ্য পরিবেশন করা - এবং আপনি যদি চান সব মাত্র একটি কমান্ড অধিকাংশ মৌলিক ব্যবহার, সব ঘন্টাধ্বনি সম্পর্কে পড়া হয় এবং whistles কমই প্রয়োজন।
বার্ড কোপ্পেরুদ

@ কুসালানন্দ এটি কমান্ডের উপরও নির্ভর করতে পারে। আমি জানি বেশিরভাগ ইউনিক্স এবং জিএনইউ ব্যবহারগুলি নথিবদ্ধ, তবে বুদ্ধিমান কিছু করার জন্য আপনার ডকুমেন্টেশন দরকার need নতুন সোলারিস কমান্ডগুলি (বিশেষত zfs) বেশ প্রাকৃতিকভাবে ডিজাইন করা হয়েছে। উদাহরণস্বরূপ, zfs destroy pool/filesystemব্যবহারের 90% ক্ষেত্রে মৌলিক ব্যবহার এবং জরিমানা। মত সংক্ষিপ্ত অপশন -rজন্য recursiveআরো বিশেষ এবং ব্যবহারের পূর্বে আলোচনা প্রয়োজন, কারণ তারা অনিচ্ছাকৃত পার্শ্ব প্রতিক্রিয়া থাকতে পারে।
ব্যবহারকারী 121391

26

আমি মনে করি না এর একটি ভাল উত্তর আছে। এটা একটা সংস্কৃতির জিনিস। কিছু ম্যান পেজের উদাহরণ ব্যবহার রয়েছে। যেমন man rsync। ম্যান পেজ লেখকের কাছে লিখিতভাবে এবং তাকে বা তার নমুনা ব্যবহারের জন্য কিছু বলার বা কিছু নমুনা ব্যবহারের উদাহরণ নিজেই উপস্থাপনের মাধ্যমে তাকে সংস্কৃতি পরিবর্তনের চেষ্টা করতে পারেন। আপনি যদি কোনও মুক্ত সফ্টওয়্যার লেখককে একটি প্যাচ, বিশেষত একটি ডকুমেন্টেশন প্যাচ সরবরাহ করেন তবে সাধারণ অনুরোধের চেয়ে কাঙ্ক্ষিত ফলাফল অর্জনের সম্ভাবনা প্রায় দশ হাজার গুণ বেশি।


7

এটা নির্ভর করে:

  • আপনার আকর্ষণীয় মনে হতে পারে এমন বেশিরভাগ প্রোগ্রাম প্রাথমিকভাবে কোনও সমস্যা সমাধানের জন্য এবং পরে সমাধানের উন্নতির জন্য কিছু সময়ের জন্য বিকাশ করা হয়। প্রোগ্রামগুলির বিকাশকারীরা যা জানার জন্য তাদের গুরুত্বপূর্ণ মনে করেছিল তা ব্যাখ্যা করে (এবং ডকুমেন্টেশন যে সমস্যাটি তারা সমাধান করছিলেন তা নয়)।
  • কিছু প্রোগ্রামের জন্য, বিকাশকারীরা নমুনা প্রোগ্রাম বা স্ক্রিপ্ট সরবরাহ করতে পছন্দ করেন যা কোনও প্রদত্ত প্রোগ্রাম (বা গ্রন্থাগার) কীভাবে ব্যবহার করতে হয় তা দেখায়। আবার কোনও সমস্যা সমাধানের জন্য এটি করা হয়: প্রোগ্রামটি পরীক্ষা করা সহজ করে তোলে।

    কয়েকটি উদাহরণ ব্যবহারকারীদের বাগ রিপোর্টের উপর ভিত্তি করে হতে পারে এবং যখন ম্যানুয়ালটিতে সংক্ষিপ্ত স্থান পায়। দৈর্ঘ্যের উদাহরণগুলি ম্যানুয়ালগুলিতে খুব কমই সরবরাহ করা হয় এবং সংক্ষিপ্ত উদাহরণগুলির মধ্যে এমন সমস্যা রয়েছে যে তারা তুচ্ছ, পুনরাবৃত্তিযোগ্য এবং ব্যবহারকারীর পক্ষে কোনও প্রোগ্রামের কাজ করার মতো সুসংগঠিত বিবরণের মতো যথাযথ অন্তর্দৃষ্টি প্রদান করে না।

  • কিছু ক্ষেত্রে আপনি ডকুমেন্টেশন পাবেন যা অন্যদের দ্বারা সরবরাহ করা হয়েছে যা উন্নয়ন প্রক্রিয়াতে জড়িত নয় । এটি হ'ল বিকাশকারীরা ডকুমেন্টেশন পর্যালোচনা ছাড়া অংশ নেন নি। এই ধরণের প্রচেষ্টা উপেক্ষা করা যেতে পারে।

5
"এই ধরণের প্রচেষ্টা উপেক্ষা করা যেতে পারে।" আমি এর অর্থ কি তা নিশ্চিত নই।
ফাহিম মিঠা

ডকুমেন্টেশন যখন কোনও অভিজ্ঞতার ভিত্তিতে না হয় তখন দরকারী কিছু অবদান রাখে না।
থমাস ডিকি 18 ই

আসলে অভিজ্ঞতার ভিত্তিতে নয় ডকুমেন্টেশন একটি নেতিবাচক অবদান রাখতে পারে - যেমন এটি কেবল সাধারণ ভুল।
আলেফজেরো

অবশ্যই - আমি এটি উল্লেখ করেছি কারণ ওপি নিঃসন্দেহে মনে রাখে এমন কয়েকটি উদাহরণ এই বিভাগের মধ্যে পড়ে (আমি এই ফোরামে একটি তালিকা সরবরাহ করা থেকে বিরত থাকব)।
থমাস ডিকি

2
@ThomasDickey। আমি এই মূল্যায়নের সাথে সম্পূর্ণ একমত নই। কোনও ইউটিলিটি লেখার ক্ষমতা অগত্যা শেষ ব্যবহারকারীকে এপিআই ব্যাখ্যা করার দক্ষতার সাথে আসে না। টি
চিগসি

6

আপনি যদি ম্যান পেজগুলির বিকল্প খুঁজছেন, আপনি সর্বদা ব্রো পৃষ্ঠাগুলি চেষ্টা করতে পারেন , যা কেবলমাত্র একটি আদেশের বিভিন্ন উদাহরণ দেখায়, যা আপনি সম্প্রদায়-জমা দেওয়া উদাহরণগুলির তালিকার মধ্যে ভোট দিতে পারেন। উদাহরণস্বরূপ, আদেশটি bro tarআপনাকে দেবে:এখানে চিত্র বর্ণনা লিখুন

আমাদের সাইট ব্যবহার করে, আপনি স্বীকার করেছেন যে আপনি আমাদের কুকি নীতি এবং গোপনীয়তা নীতিটি পড়েছেন এবং বুঝতে পেরেছেন ।
Licensed under cc by-sa 3.0 with attribution required.