คำถามติดแท็ก comments

ฉันกำลังเขียนไฟล์แบตช์และฉันพบคู่มือผู้ใช้ซึ่งมีข้อมูลมาก สิ่งหนึ่งที่แสดงให้ฉันเห็นก็คือบรรทัดนั้นสามารถให้ความเห็นได้ไม่เพียงแค่กับREMแต่ยังรวม::ถึง มันบอกว่า: ความคิดเห็นในรหัสแบตช์สามารถทำได้โดยใช้เครื่องหมายทวิภาคคู่ซึ่งเป็นการดีกว่าการใช้คำสั่ง REM เนื่องจากมีการประมวลผลป้ายกำกับก่อนที่จะเปลี่ยนสัญลักษณ์ ::<remark>ไม่มีปัญหา แต่rem <remark>ก่อให้เกิดข้อผิดพลาด ทำไมทำเช่นนั้นคู่มือและตัวอย่างส่วนใหญ่ที่ฉันเห็นใช้REMคำสั่ง? ใช้::งานได้กับ Windows ทุกรุ่นหรือไม่

284 batch-file  coding-style  comments 

ฉันจะเพิ่มความคิดเห็นในไฟล์การกำหนดค่าของ Vim ได้อย่างไร .vimrc?

276 vim  comments  configuration-files 

ตามที่เป็นอยู่ในปัจจุบันคำถามนี้ไม่เหมาะสำหรับรูปแบบคำถาม & คำตอบของเรา เราคาดหวังคำตอบที่จะได้รับการสนับสนุนจากข้อเท็จจริงการอ้างอิงหรือความเชี่ยวชาญ แต่คำถามนี้มีแนวโน้มที่จะเรียกร้องการอภิปรายการโต้แย้งการหยั่งเสียงหรือการอภิปรายเพิ่มเติม หากคุณรู้สึกว่าคำถามนี้สามารถปรับปรุงและเปิดใหม่ได้โปรดไปที่ศูนย์ช่วยเหลือเพื่อขอคำแนะนำ ปิดให้บริการใน7 ปีที่ผ่านมา ฉันมีเพื่อนร่วมงานที่ยืนยันว่ารหัสของเขาไม่ต้องการความคิดเห็นมันเป็น "การทำเอกสารด้วยตนเอง" ฉันได้ตรวจสอบรหัสของเขาแล้วและแม้ว่าจะชัดเจนกว่ารหัสที่ฉันเคยเห็นคนอื่นทำ แต่ฉันก็ยังไม่เห็นด้วยว่ารหัสการจัดทำเอกสารด้วยตนเองนั้นสมบูรณ์และมีประโยชน์เช่นเดียวกับการแสดงความคิดเห็นและรหัสที่เป็นเอกสาร ช่วยให้ฉันเข้าใจเขามุมมอง รหัสเอกสารด้วยตนเองคืออะไร มันสามารถแทนที่รหัสความคิดเห็นดีและเอกสาร มีสถานการณ์ที่ดีกว่ารหัสดีและแสดงความคิดเห็น มีตัวอย่างที่รหัสไม่สามารถจัดทำเอกสารด้วยตนเองได้โดยไม่ต้องแสดงความคิดเห็น อาจเป็นเพียงข้อ จำกัด ของตัวเอง แต่ฉันไม่เห็นว่ามันจะเป็นการปฏิบัติที่ดีได้อย่างไร นี่ไม่ได้หมายความว่าจะเป็นข้อโต้แย้ง - โปรดอย่าอธิบายเหตุผลที่ทำไมความเห็นที่ดีและรหัสเอกสารมีความสำคัญสูง - มีแหล่งข้อมูลมากมายที่แสดงสิ่งนี้ แต่พวกเขาไม่เชื่อต่อเพื่อนของฉัน ฉันเชื่อว่าฉันต้องเข้าใจมุมมองของเขาให้มากขึ้นเพื่อโน้มน้าวเขาอย่างอื่น เริ่มคำถามใหม่ถ้าคุณต้องการ แต่อย่าเถียงที่นี่ ว้าวตอบสนองอย่างรวดเร็ว! โปรดอ่านคำตอบที่มีอยู่ทั้งหมดและแสดงความคิดเห็นต่อคำตอบแทนที่จะเพิ่มคำตอบใหม่เว้นแต่คำตอบของคุณจะแตกต่างอย่างมากจากคำตอบอื่น ๆ ทั้งหมดที่นี่ นอกจากนี้พวกคุณที่กำลังโต้เถียงกับการทำเอกสารด้วยตนเอง - นี่คือหลักที่จะช่วยให้ฉันเข้าใจมุมมอง (กล่าวคือแง่มุมที่ดี) ของผู้สอนศาสนารหัสการทำเอกสารด้วยตนเอง ฉันคาดว่าคนอื่นจะลงคะแนนคุณถ้าคุณไม่อยู่ในหัวข้อ

258 documentation  comments 

ตกลงฉันทราบว่าสตริงสามใบเสนอราคาสามารถใช้เป็นความคิดเห็นแบบหลายบรรทัดได้ ตัวอย่างเช่น, """Hello, I am a multiline comment""" และ '''Hello, I am a multiline comment''' แต่ในทางเทคนิคแล้วการพูดเหล่านี้เป็นสตริง ฉันอ่านและอ่านคู่มือสไตล์ Python แต่ฉันไม่สามารถหาคำตอบทางเทคนิคได้ว่าทำไมไม่มีการใช้งานแบบหลายบรรทัดอย่างเป็นทางการ / * * / ประเภทความคิดเห็น ฉันไม่มีปัญหาในการใช้คำพูดสามคำ แต่ฉันอยากรู้อยากเห็นเล็กน้อยเกี่ยวกับสิ่งที่นำไปสู่การตัดสินใจออกแบบนี้

252 python  comments  multiline 

ฉันเพิ่งเริ่มศึกษาเชลล์สคริปต์และฉันต้องการที่จะแสดงความคิดเห็นชุดของบรรทัดในเชลล์สคริปต์ ฉันหมายถึงชอบในกรณีของ C / Java: /* comment1 comment2 comment3 */` ฉันจะทำสิ่งนั้นได้อย่างไร

226 shell  comments  multiline 

มีวิธีที่จะแสดงความคิดเห็นออกมาร์กอัปใน.ASPXหน้าเว็บเพื่อไม่ให้ส่งถึงลูกค้าหรือไม่ ฉันลองความคิดเห็นมาตรฐาน<!-- -->แต่สิ่งนี้เพิ่งได้รับการส่งเป็นความคิดเห็นและไม่ได้ป้องกันการแสดงผล

208 asp.net  markup  comments 

มีวิธีที่เป็นทางการใด ๆ ในการอนุญาตให้ไฟล์ที่จัดรูปแบบ CSV สามารถแสดงความคิดเห็นไม่ว่าจะเป็นในบรรทัดของตนเองหรือในตอนท้ายของบรรทัด ฉันพยายามตรวจสอบวิกิพีเดียเกี่ยวกับเรื่องนี้และRFC 4180แต่ทั้งคู่ไม่ได้พูดถึงสิ่งใดที่ทำให้ฉันเชื่อว่ามันไม่ใช่ส่วนหนึ่งของรูปแบบไฟล์ดังนั้นฉันจึงโชคดีและฉันควรใช้ไฟล์ ReadMe.txt แยกต่างหากเพื่ออธิบาย ไฟล์. สุดท้ายฉันรู้ว่ามันง่ายสำหรับฉันที่จะเพิ่มความคิดเห็นของตัวเองใน แต่ฉันหวังว่าบางสิ่งเช่น Excel สามารถนำเข้าได้ทันทีโดยไม่จำเป็นต้องให้ผู้บริโภคต้องปรับแต่งกระบวนการนำเข้า ดังนั้นความคิด

203 csv  comments  standards  file-format 

ความแตกต่างระหว่างอะไร /** * comment * * */ และ /* * * comment * */ ใน Java? ฉันควรใช้เมื่อใด

192 java  comments  javadoc 

ปิด. คำถามนี้ไม่เป็นไปตามหลักเกณฑ์กองมากเกิน ไม่ยอมรับคำตอบในขณะนี้ ต้องการปรับปรุงคำถามนี้หรือไม่ อัปเดตคำถามเพื่อให้เป็นไปตามหัวข้อสำหรับ Stack Overflow ปิดให้บริการใน2 ปีที่ผ่านมา ปรับปรุงคำถามนี้ หนึ่งในฟีเจอร์ใหม่ของXcode 5คือความสามารถในการจัดทำเอกสารโค้ดของคุณเองด้วยไวยากรณ์ความคิดเห็นพิเศษ รูปแบบคล้ายกับ doxygen แต่ดูเหมือนจะรองรับชุดย่อยของคุณลักษณะเหล่านั้นเท่านั้น สนับสนุนคำสั่งใดและคำสั่งใดไม่ ประเพณีของพวกเขาแตกต่างจาก Doxygen หรือไม่?

186 objective-c  documentation  comments  doxygen  xcode5 

Eclipse มีปุ่มลัดเพื่อแสดงความคิดเห็นบล็อกหรือไม่ และยกเลิกการใส่ข้อคิดเห็นบล็อก?

185 eclipse  comments  hotkeys 

ความคิดเห็นเป็นไปได้ใน Jenkinsfile? ถ้าใช่ไวยากรณ์คืออะไร ฉันใช้ไวยากรณ์ไปป์ไลน์ที่ประกาศได้ ฉันต้องการแสดงความคิดเห็นในส่วน "โพสต์" ด้านล่างจนกว่าเซิร์ฟเวอร์ SMTP ของฉันจะใช้งานได้ pipeline { agent { label 'docker-build-slave' } environment { IMAGE = 'registry.gitlab.com/XXXXX/bible-server' DOCKER_REGISTRY_CREDENTIALS = credentials('DOCKER_REGISTRY_CREDENTIALS') } options { timeout(10) } stages { stage('Test') { steps { sh 'yarn' sh 'npm test' } } stage('Build') { when { branch '*/master' } steps …

177 jenkins  groovy  comments  jenkins-pipeline 

มองดูbuild.gradleไฟล์นี้ apply plugin: 'com.android.application' android { compileSdkVersion 21 buildToolsVersion "21.1.2" defaultConfig { applicationId "package.myapp" minSdkVersion 19 targetSdkVersion 21 versionCode 1 versionName "1.0" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } } dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) compile 'com.nineoldandroids:library:2.4.0' } เกิดอะไรขึ้นถ้าผมอยากจะเขียนความคิดเห็นเกี่ยวกับทำไมผมเลือกห้องสมุดนี้สำหรับโครงการนี้ , ไวยากรณ์สำหรับการเขียนความคิดเห็นในbuild.gradleไฟล์คืออะไร?

174 android  gradle  comments  android-gradle-plugin  build.gradle 

ฉันจะแสดงความคิดเห็นในแต่ละบรรทัดของบรรทัดต่อไปนี้จากสคริปต์ได้อย่างไร cat ${MYSQLDUMP} | \ sed '1d' | \ tr ",;" "\n" | \ sed -e 's/[asbi]:[0-9]*[:]*//g' -e '/^[{}]/d' -e 's/""//g' -e '/^"{/d' | \ sed -n -e '/^"/p' -e '/^print_value$/,/^option_id$/p' | \ sed -e '/^option_id/d' -e '/^print_value/d' -e 's/^"\(.*\)"$/\1/' | \ tr "\n" "," | \ sed -e 's/,\([0-9]*-[0-9]*-[0-9]*\)/\n\1/g' …

165 bash  syntax  comments 

ไวยากรณ์สำหรับความคิดเห็น TypeScript มีการบันทึกไว้ทุกที่หรือไม่? และตอนนี้มันรองรับระบบ C # ///หรือไม่?

165 comments  typescript 

# noqaขณะที่การค้นหาผ่านโครงการหลามผมพบว่าไม่กี่บรรทัดแสดงความคิดเห็นด้วย import sys sys.path.append(r'C:\dev') import some_module # noqa อะไรnoqaหมายถึงในงูใหญ่? มันเฉพาะเจาะจงกับงูหลามเท่านั้น?

162 python  comments  terminology  code-analysis  pep8