title: How to make Xcode display comments below user-defined methods?
body: <p>If we type a method from Apple API, Xcode will display method functions below the auto-complete pop-up list. But typing a user-defined method, it shows nothing.</p>
  <p>Is there a way to tell Xcode to display some descriptions that I defined by myself to show how to use the user-defined methods?</p>
  <p>Thank you!!!</p>
  <hr />
  <p>@HAS:</p>
  <p>I follow your instruction till Step 12, and create a simple test class in .h file as:</p>
  <pre><code>#import &lt;Foundation/Foundation.h&gt;
  
  @interface AMCAppleDocTest : NSObject
  @property (nonatomic, retain) NSString *version;
  + (id) test;
  /** @name Section title */
  /** Method description */
  - (void)doSomething;
  @end
  </code></pre>
  <p>Then to Step 13, I run the script, but error occurred as picture below:</p>
  <p><a href="https://i.stack.imgur.com/Qazed.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/Qazed.png" alt="" /></a></p>
  
  <p>My .sh script:</p>
  <pre><code>#! /bin/sh
  docsURL=&quot;http://www.AMC.com&quot;;
  projectsPath=&quot;$2/../&quot;;
  docsPath=&quot;/Users/AMC/Library/Developer/Documentations/$1&quot;;
  
  # create AppleDocOutput folder if not exists
  if [ ! -d $docsPath ];
  then
  mkdir &quot;${docsPath}&quot;;
  fi
  
  /Users/AMC/Library/Developer/DocumentationStuff/appledoc \
  --project-name &quot;$1&quot; \
  --project-company &quot;AMC&quot; \
  --company-id &quot;com.AMC&quot; \
  --docset-atom-filename &quot;$1.atom&quot; \
  --docset-feed-url &quot;${docsURL}/%DOCSETATOMFILENAME&quot; \
  --output &quot;/Users/AMC/Library/Developer/Documentations/$1&quot; \
  --docset-package-url &quot;${docsURL}/%DOCSETPACKAGEFILENAME&quot; \
  --docset-fallback-url &quot;${docsURL}/$1Doc/&quot; \
  --publish-docset \
  --logformat xcode \
  --keep-undocumented-objects \
  --keep-undocumented-members \
  --keep-intermediate-files \
  --no-repeat-first-par \
  --no-warn-invalid-crossref \
  --ignore &quot;*.m&quot; \
  --ignore &quot;LoadableCategory.h&quot; \
  --index-desc &quot;$2/readme.markdown&quot; \
  &quot;$2&quot; &gt; &quot;${docsPath}/AppleDoc.log&quot;
  </code></pre>
  <p>And the .command file:</p>
  <pre><code>#!/usr/bin/osascript
  
  tell application &quot;Xcode&quot;
      tell first project
          -- variables to export
          set projectName to (get name)
          set projectDir to (get project directory)
          set company to (get organization name)
          -- invoke script passing extracted variables
          do shell script (&quot;sh /Users/AMC/Library/Developer/DocumentationStuff/appledoc.generate.sh &quot; &amp; projectName &amp; &quot; &quot; &amp; projectDir &amp; &quot; &quot; &amp; company)
      end tell
  end tell
  </code></pre>
  <p>And besides, my Xcode version is 4.5.1 and OS X 10.8.</p>
  <p>Xcode is not installed into /Applications folder but simply put at desktop. Does it matter?</p>
  <hr />
  <p>@ HAS, again</p>
  <p>I found what went wrong: the script was in dos format. I solved that in VI using <i>:set ff=unix</i>. Now every things goes perfectlly:</p>
  <p><a href="https://i.stack.imgur.com/3Lone.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/3Lone.png" alt="" /></a></p>