2012-01-16 20 views
12

मैं मिश्रित जावा/स्कैला प्रोजेक्ट के लिए एसबीटी 0.11.2 का उपयोग कर रहा हूं। मुझे एहसास हुआ है कि जब मैं doc कमांड को एसबीटी के भीतर से चलाता हूं, तो यह न केवल src/main/scala में स्कैला स्रोत फ़ाइलों के लिए स्केलडॉक्स बनाता है, बल्कि जावा स्रोत फ़ाइलों के लिए भी src/main/java में (एसबीटी विकी दावा करता है कि उन्हें src/main/scala केवल यह सच नहीं लगता है)।दस्तावेज़ कार्य में जावा स्रोत फ़ाइलों को कैसे बाहर निकालना है?

हालांकि, यह बहुत अच्छी तरह से नहीं दिखता है। उदाहरण के लिए, Foo नामक जावा क्लास के लिए स्थैतिक तरीकों के साथ उत्पन्न स्केलैडोक में दो प्रविष्टियां हैं: Foo कक्षा और Foo ऑब्जेक्ट। कक्षा केवल निर्माता को सूचीबद्ध करती है और ऑब्जेक्ट स्थिर विधियों को सूचीबद्ध करता है।

क्या कोई तरीका है कि मैं sbt को स्केलैड पीढ़ी से src/main/java फ़ोल्डर को बाहर करने के लिए कह सकता हूं? मैं इसके बजाय उन लोगों के लिए javadocs बनाना चाहता हूं।

उत्तर

12

इसे संभालने का सामान्य तरीका inspect का उपयोग यह देखने के लिए है कि जानकारी कहां से आ रही है, और फिर इसे बदलें। doc पर निरीक्षण compile:sources(for doc) से पता चलता है, जो एक Seq[java.io.File] है, और इस तरह बदला जा सकता है:

sources in (Compile, doc) ~= (_ filter (_.getName endsWith ".scala")) 

आप को देखने के लिए इसमें क्या है show compile:sources(for doc) उपयोग कर सकते हैं, और फिर set यह बदल कर फिर से अपने मूल्य की जाँच करने के।

+1

धन्यवाद डैनियल, इस परियोजना को मेरे प्रोजेक्ट के 'build.sbt' में जोड़ने से समस्या हल हो जाती है। दुर्भाग्यवश, एसबीटी का दस्तावेज प्रत्येक सुविधा को समझाने और उन्नत सेटिंग्स को कॉन्फ़िगर करने में काफी सतही है जैसे कि यह मेरे जैसे स्कैला शुरुआती लोगों के लिए नहीं है। उम्मीद है कि स्कैला और उसके पुस्तकालयों के पूरे दस्तावेज पहलू पर अधिक ध्यान दिया जाएगा। – pemistahl

+1

@ पीटरस्टहल मैं असहमत होना चाहता हूं। एसबीटी दस्तावेज क्विकस्टार्ट पर और फिर उन्नत विषयों में इसे बड़े पैमाने पर कवर करता है। यह उपर्युक्त दृष्टिकोण को बहुत अधिक सिखाता है: कार्य के कार्यकलापों को कैसे खोजा जाए, और फिर इसे ओवरराइड कैसे करें। मुझे यह पता है, क्योंकि यह मुश्किल से एक महीना रहा है क्योंकि मुझे बुनियादी सेटिंग्स से गहराई से खोदना पड़ा था, और उपरोक्त सभी मैंने एसबीटी विकी पर सीखा। –

+1

मैं मानता हूं कि आवश्यक जानकारी [इस पृष्ठ] पर मिल सकती है (https://github.com/harrah/xsbt/wiki/Getting-Started-More-About- सेटिंग्स)। हालांकि, मेरे लिए अपनी समस्याओं को नई समस्याओं में अनुकूलित करना मुश्किल है। एसबीटी विकी की व्यावहारिक तैयारी बेहतर हो सकती है। विशेष रूप से अधिक उदाहरण कई चीजों को स्पष्ट करेंगे। इसके अलावा, मैं केवल सामान्य रूप से स्कैला की प्रलेखन स्थिति के बारे में बात कर रहा था, न केवल एसबीटी। वैसे भी, यह चर्चा करने के लिए यह सही जगह नहीं है, तो चलिए बस यहां खत्म करें। एक बार फिर धन्यवाद! – pemistahl