tomaz / appledoc

Objective-c code Apple style documentation set generator.
http://gentlebytes.com
4.2k stars 644 forks source link

index.html has no comment of code #611

Open gshushu opened 7 years ago

gshushu commented 7 years ago

Create doc success(guess) ,in the content of file, index.html just has a name of Class , no property, no method, it's empty.just Index, Hierarchy, and On this page list.

naftaly commented 7 years ago

same results here. Not exactly sure what changed. here the cmd I use:

/usr/local/bin/appledoc \
--project-name "${PROJECT_NAME}" \
--project-company "${company}" \
--company-id "${companyID}" \
--docset-atom-filename "${company}.atom" \
--docset-feed-url "${companyURL}/${company}/%DOCSETATOMFILENAME" \
--docset-package-url "${companyURL}/${company}/%DOCSETPACKAGEFILENAME" \
--docset-fallback-url "${companyURL}/${company}" \
--output "${outputPath}" \
--publish-docset \
--docset-platform-family "${target}" \
--logformat xcode \
--keep-intermediate-files \
--no-repeat-first-par \
--no-warn-invalid-crossref \
--use-code-order \
--no-install-docset \
--create-html \
--create-docset \
--keep-undocumented-objects \
--keep-undocumented-members \
--repeat-first-par \
--print-information-block-titles \
--use-single-star \
--ignore .m \
--ignore .mm \
--ignore Releases \
--ignore Frameworks \
--exit-threshold 2 \
"${PROJECT_DIR}/file1.h" \
"${PROJECT_DIR}/file2.h" \
"${PROJECT_DIR}/file3.h" \
"${PROJECT_DIR}/file4.h"
Insofan commented 6 years ago

me 2,have you fix it?

tomaz commented 6 years ago

Did you try debugging with --verbose setting to see what gets parsed? Use at least 5 to get this much data to output...

Insofan commented 6 years ago

@tomaz I write this in m ` @interface MainTableViewController ()

\/! @brief This property knows View Controller array. \/ @property (strong, nonatomic) NSArray *vcArray; @end ` and type sub in terminal

appledoc --verbose 5 --no-create-docset --output ./doc --project-name Insofan --project-company "Insofan" --company-id "com.Insofan" .\/ teminal says WARN | MainTableViewController is not documented! no comment in index and it seems didn't support cocoapod's framework. I have to clean pods use appledoc then reinstall pods

tomaz commented 6 years ago

Try changing your comment to:

/**
This property knows View Controller array.
*/

to see what happens

Insofan commented 6 years ago

@tomaz Still nothing.Btw, my project on xcode9 and deleted pods. sub is my script

#appledoc Xcode script
  # Start constants
company="Insofan";
companyID="com.Insofan";
companyURL="https://github.com/insofan";
target="iphoneos";
 #target="macosx";
outputPath="~/help";\

/usr/local/bin/appledoc \
--project-name "${PROJECT_NAME}" \
--project-company "${company}" \
--company-id "${companyID}" \
--docset-atom-filename "${company}.atom" \
--docset-feed-url "${companyURL}/${company}/%DOCSETATOMFILENAME" \
--docset-package-url "${companyURL}/${company}/%DOCSETPACKAGEFILENAME" \
--docset-fallback-url "${companyURL}/${company}" \
--output "${outputPath}" \
--publish-docset \
--docset-platform-family "${target}" \
--logformat xcode \
--keep-intermediate-files \
--no-repeat-first-par \
--no-warn-invalid-crossref \
--exit-threshold 2 \
"${PROJECT_DIR}"
tomaz commented 6 years ago

Try also adding some comment to the class itself.

cslmark commented 5 years ago

Xcode10 the same result. it's empty.just Index, Hierarchy, and On this page list. How to solve it!

tmcguire commented 3 years ago

This could be a duplicate of https://github.com/tomaz/appledoc/issues/561#issuecomment-149327949. In that issue, the problem was missing templates, which are not installed when using homebrew to install appledoc.