मैं ruby-doc.org की देखरेख के लिए एक ई-मेल लिखने का फैसला किया और पूछा इन तरीकों के लापता दस्तावेज के बारे में उन्हें। मुझे निम्नलिखित उत्तर प्राप्त हुआ:
वे निजी तरीके हैं, और डिफ़ॉल्ट रूप से rdoc आउटपुट में दिखाई नहीं देते हैं।
यह एक दुर्भाग्यपूर्ण स्थिति है, क्योंकि अधिकांश निजी तरीकों (जिसका उपयोग से बचा जाना चाहिए वे आम तौर पर कर रहे हैं के बाद से कार्यान्वयन विवरण, नहीं एक सार्वजनिक एपीआई का हिस्सा) attr_ * और इस तरह वास्तव में सामान्य उपयोग के लिए करना है के विपरीत है।
सुनिश्चित नहीं हैं कि क्या सही समाधान यहाँ है।
जेम्स
एक दूसरे मेल में:
मैं ग्रेग ब्राउन, एरिक Hodel, और कुछ अन्य लोगों को जो 1.9 के लिए rdocs सुधार करने के लिए काम कर रहा है के साथ इस पर चर्चा की।
आम सहमति है कि सभी निजी तरीकों का प्रदर्शन करने में है कि यह (शायद अनजाने) उपयोग तरीकों कि एक नाबालिग रिलीज से अगले करने के लिए बदलने के लिए उत्तरदायी हैं के लिए लोगों को प्रोत्साहित करेगा एक बुरा विचार होगा। लेकिन वे सराहना attr_ * की तरह निजी तरीके हैं कि, जबकि तकनीकी रूप से निजी, सार्वजनिक रास्ते का एक प्रकार में और उस डॉक्स डिफ़ॉल्ट रूप से प्रदर्शित करने की आवश्यकता पर इस्तेमाल किया।
मैं सी स्रोत कोड में इन के लिए कोड पर कुछ rdoc निर्देशों की स्थापना की कोशिश की, लेकिन यह कोई प्रभाव नहीं पड़ा।ऐसा लगता है कि की आवश्यकता है यह इंगित करने के लिए कुछ अतिरिक्त तरीका है कि, व्यवहारिक रूप से, एक विधि निजी है, लेकिन दस्तावेज़ों के लिए यह सार्वजनिक है।
मुझे यह देखने के लिए इसका पालन करना होगा कि 1.9 डॉक्टर-सुधार टीम कुछ भी हो गया है या नहीं।
धन्यवाद,
जेम्स ब्रिट
इसके अलावा अधिक जानकारी और इस मुद्दे के बारे में जेम्स द्वारा एक और बयान के लिए this thread देखते हैं। इस धागे में, वह यह भी कहता है कि :doc:
निर्देश आमतौर पर आरडीओसी में उपलब्ध है ताकि रूबी कोड में इस सटीक समस्या को सी-लेवल प्रलेखन के लिए काम न लगे।
यह उत्तर समझदार लगता है। शायद वे इसे भविष्य में बदल देंगे।
स्रोत
2012-01-08 16:00:21
हाँ, मैंने इसे भी देखा है। जब मैं कुछ सीखना चाहता हूं तो मैं प्रलेखन पर एक अद्भुत साइट यहां पसंद करता हूं: http://www.rubyist.net/~slagell/ruby/accessors.html। मुझे यकीन है कि ruby-doc.org पर कोई दस्तावेज नहीं है क्योंकि: http://ruby-doc.org/search.html?cx=011815814100681837392%3Awnccv6st5qk&q=attr_accessor&sa=Search&cof=FORID%3A9 – itdoesntwork