Skip to content

Commit 06e3da4

Browse files
committed
Update read me
Signed-off-by: onevcat <onevcat@gmail.com>
1 parent 2d51434 commit 06e3da4

4 files changed

Lines changed: 65 additions & 4 deletions

File tree

README.md

Lines changed: 57 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,57 @@
1-
VVDocumenter-Xcode
2-
==================
1+
# VVDocumenter-Xcode
2+
---
3+
4+
## What is this?
5+
6+
Writing document is so important for developing, but it is really painful with Xcode. Think about how much time you are wasting in pressing '*' or '/', and typing the parameters again and again. Now, you can find the method or any code you want to document, and type in `///`, the document will be generated for you and all params and return will be extracted in a beatiful Javadoc style. You can just fill the inline placeholders to finish your document。
7+
8+
Here is an image which can show what it exactly does.
9+
10+
![Screenshot](https://raw.github.com/onevcat/VVDocumenter-Xcode/master/ScreenShot.gif)
11+
12+
## How to use it?
13+
14+
Build the `VVDocumenter-Xcode` target in the Xcode project and the plug-in will automatically be installed in `~/Library/Application Support/Developer/Shared/Xcode/Plug-ins`. Relaunch Xcode and type in `///` above any code you want to write a document to.
15+
16+
## Xcode version?
17+
18+
This plug-in is developed and tested in Xcode 4.6.3. It should work in all versions of Xcode 4. If you want to use it in Xcode 5 (DP3 or above), you have to make a liittle change in the plist. This is all what I can say under the NDA. And one more thing, the 'undo' is not working with Xcode 5.
19+
20+
## Limitations
21+
22+
There are a set of code type I hope to supprt, but now I just finished some of them.
23+
24+
* Objc Method (Done)
25+
* C Function (Done)
26+
* Macro (Done)
27+
* Property (Done)
28+
* Variable (Done)
29+
* Enum (To do)
30+
* Struct (To do)
31+
* Union (To do)
32+
33+
Now the docs for to-do types will be generated only with a basic description (which is the same as Property and Variable).
34+
35+
36+
## License
37+
38+
VVDocumenter is published under MIT License
39+
40+
Copyright (c) 2013 Wei Wang (@onevcat)
41+
42+
Permission is hereby granted, free of charge, to any person obtaining a copy of
43+
this software and associated documentation files (the "Software"), to deal in
44+
the Software without restriction, including without limitation the rights to use,
45+
copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
46+
Software, and to permit persons to whom the Software is furnished to do so,
47+
subject to the following conditions:
48+
49+
The above copyright notice and this permission notice shall be included in all
50+
copies or substantial portions of the Software.
51+
52+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
53+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
54+
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
55+
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
56+
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
57+
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

ScreenShot.gif

454 KB
Loading

VVDocumenter-Xcode.xcodeproj/project.pbxproj

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@
3434
D1C462F517999CEC00EB7B23 /* NSString+VVSyntax.m in Sources */ = {isa = PBXBuildFile; fileRef = D1C462F417999CEC00EB7B23 /* NSString+VVSyntax.m */; };
3535
D1C462F617999CEC00EB7B23 /* NSString+VVSyntax.m in Sources */ = {isa = PBXBuildFile; fileRef = D1C462F417999CEC00EB7B23 /* NSString+VVSyntax.m */; };
3636
D1C462F717999D0600EB7B23 /* NSString+PDRegex.m in Sources */ = {isa = PBXBuildFile; fileRef = D114BEDE179644D00043FA65 /* NSString+PDRegex.m */; };
37+
D1EBD4AA179AE763003A081D /* DVTKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = D1EBD4A9179AE763003A081D /* DVTKit.framework */; };
3738
/* End PBXBuildFile section */
3839

3940
/* Begin PBXFileReference section */
@@ -88,13 +89,15 @@
8889
D1C462F017999CA200EB7B23 /* SyntaxTests.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SyntaxTests.m; sourceTree = "<group>"; };
8990
D1C462F317999CEC00EB7B23 /* NSString+VVSyntax.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "NSString+VVSyntax.h"; sourceTree = "<group>"; };
9091
D1C462F417999CEC00EB7B23 /* NSString+VVSyntax.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "NSString+VVSyntax.m"; sourceTree = "<group>"; };
92+
D1EBD4A9179AE763003A081D /* DVTKit.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = DVTKit.framework; path = "../../../../../Applications/Xcode5-DP3.app/Contents/SharedFrameworks/DVTKit.framework"; sourceTree = "<group>"; };
9193
/* End PBXFileReference section */
9294

9395
/* Begin PBXFrameworksBuildPhase section */
9496
D14380F0179551B900C829CE /* Frameworks */ = {
9597
isa = PBXFrameworksBuildPhase;
9698
buildActionMask = 2147483647;
9799
files = (
100+
D1EBD4AA179AE763003A081D /* DVTKit.framework in Frameworks */,
98101
D14380F7179551B900C829CE /* Cocoa.framework in Frameworks */,
99102
);
100103
runOnlyForDeploymentPostprocessing = 0;
@@ -161,6 +164,7 @@
161164
D14380F5179551B900C829CE /* Frameworks */ = {
162165
isa = PBXGroup;
163166
children = (
167+
D1EBD4A9179AE763003A081D /* DVTKit.framework */,
164168
D14380F6179551B900C829CE /* Cocoa.framework */,
165169
D1C462DB17999C2000EB7B23 /* SenTestingKit.framework */,
166170
D14380F8179551B900C829CE /* Other Frameworks */,
@@ -503,7 +507,8 @@
503507
DSTROOT = "${HOME}";
504508
FRAMEWORK_SEARCH_PATHS = (
505509
"$(inherited)",
506-
"\"$(SRCROOT)/VVDocumenter-Xcode\"",
510+
"\\\"$(SRCROOT)/VVDocumenter-Xcode\\\"",
511+
"$(SYSTEM_APPS_DIR)/Xcode5-DP3.app/Contents/SharedFrameworks",
507512
);
508513
GCC_ENABLE_OBJC_GC = supported;
509514
GCC_PRECOMPILE_PREFIX_HEADER = YES;
@@ -524,7 +529,8 @@
524529
DSTROOT = "${HOME}";
525530
FRAMEWORK_SEARCH_PATHS = (
526531
"$(inherited)",
527-
"\"$(SRCROOT)/VVDocumenter-Xcode\"",
532+
"\\\"$(SRCROOT)/VVDocumenter-Xcode\\\"",
533+
"$(SYSTEM_APPS_DIR)/Xcode5-DP3.app/Contents/SharedFrameworks",
528534
);
529535
GCC_ENABLE_OBJC_GC = supported;
530536
GCC_PRECOMPILE_PREFIX_HEADER = YES;

0 commit comments

Comments
 (0)