Changeset 130

Show
Ignore:
Timestamp:
02/29/08 07:07:54 (11 months ago)
Author:
yidabu
Message:

--

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • tools/scite4d/Readme.txt

    r129 r130  
    1 SciTE4D text editor 0.12 released 
    2  
    3 10 Feb 2008, SciTE4D text editor 0.12 released. 
     1SciTE4D text editor 0.15 released 
     2 
     310 Feb 2008, SciTE4D text editor 0.15 released. 
    44Up-to-date with DMD 1.024 and Tango 0.99.4 Frank. 
    55 
     
    1212Quote Neil Hodgson:"SciTE is a SCIntilla based Text Editor. Originally built to demonstrate Scintilla, it has grown to be a generally useful editor with facilities for building and running programs." 
    1313 
    14 Scite4D contains SEATD for SciTE, D programming language help CHM and build tool ybud. 
     14Scite4D contains SEATD for SciTE, D programming language help CHM and building tool ybud. 
    1515 
    1616== functionality == 
     
    2828* Ctrl + Alt + F1 - online MSDN search on the keyword were the cursor is located. 
    2929 
    30 * F7 - Debug build 
     30* F7 - Debug build (dsss) 
     31 
     32* Ctrl + F7 - Release build (dsss) 
    3133 
    3234* F5 - run the binary 
    3335 
    34 * Alt + F5 - run minid module 
    35  
    36 * Ctrl + F7 - Release build 
    37  
    38 * Alt + F7 - compile minid module 
    39  
    40 * Ctrl + Alt + Shift + D - Build documentation 
    41  
    42 * Ctrl + Alt + Shift + T - Run unittest 
    43  
    44 * Alt + D - pops up a list of the declarations in the current file 
     36* Ctrl + F5 - run "DMD -run currentfile.d args..." 
     37 
     38* Ctrl + Alt + Shift + D - Build documentation (dsss) 
     39 
     40* Ctrl + Alt + Shift + T - Run unittest (dsss) 
     41 
     42* Alt + D - pops up a list of the declarations in the current file. 
    4543 
    4644* Alt + M - pops up a list of modules 
     
    5250  If you move the cursor over the module name of an import declaration, it will jump to that module.  
    5351 
    54  
    55 == Configuration == 
    56  
    57 === Include path === 
    58  
    59 SEATD for SciTE has minimal configuration requirements. It only needs an include path to find D source files that correspond to the module names that appear in import statements. If no explicit include path is given, it tries to figure it out by itself.  
    60  
    61 In order to do so, the path of the current file and it's module name (if available) is used. For example, from a D file "/project/src/pak/bla.d" with a module declaration "module pak.bla;", SEATD for SciTE will extract "/project/src/pak/" and "/project/src/". To specify include paths that are outside of the project's source directory, you can set a global and a local include path.  
    62  
    63 SEATD for SciTE is configured through SciTE's properties files. To be able to have different settings on installation-, user- and project-level, SciTE allows global-, user- and directory option files. Usually, you only change the user- and directory options.  
    64  
    65 The global include path is supposed to be set in scite4d\SciTEGlobal.properties, the first line contain the include paths for libraries that all of your projects use (like Phobos or Tango). It is a list of paths separated by ';', for example:  
    66  
    67 seatd.global.include=c:\dmd\src\phobos;c:\tango\import 
    68  
    69 To change it, modify the line above accordingly and include it in your user options file.  
    70  
    71 More details of SEATD for SciTE, please visit: [http://seatd.mainia.de/doc.html SEATD doc] 
    72  
    73  
    74 == How to build == 
    75      
    76     SciTE4D use DSSS to build anything. 
    77  
    78     ''' 1 ''' Download and install DSSS from: 
    79     [http://www.dsource.org/projects/dsss DSSS] 
    80      
    81     Be sure dsss.exe in your environment path variable. 
    82    
    83     ''' 2 ''' configurate dsss.conf for your project. 
    84      
    85     e.g. to build ybud.exe, assume ybud.d at D:\d\scite4d\ybud.d 
    86      
    87     D:\d\scite4d\dsss.conf : 
    88     {{{ 
    89     [*] 
    90     buildflags=-explicit -SD:\d\dmd\tango\lib -lltango-base-dmd 
    91     postbuild=del *.obj *.map dsss.last 
    92      
    93     [ybud.d] 
    94     debugflags=-g -w -debug=UnitTest -unittest -version=ybudVerbose 
    95     releaseflags=-O -release -inline 
    96     target=ybud 
    97     }}} 
    98      
    99      
    100     ''' 3 ''' Press F7 or Ctrl + F7 to build your project 
    101      
    102     Click scite4d\Sc1.exe to run SciTE4d 
    103      
    104     open ybud.d in scite4d 
    105      
    106     Press F7 to debug build. 
    107      
    108     Press Ctrl + F7 to release build. 
     52* building by dsss supported 
     53 
     54* building by GNU make supported 
     55 
     56* building by Windows bat file supported 
     57 
    10958 
    11059 
     
    120692 unzip to ..\scite4d\ 
    12170 
    122 3 Click scite4d\Sc1.exe to start program. 
    123  
    124 4 open scite4d\SciTEGlobal.properties, modify seatd.global.include to fit your specific libraries path. 
    125  
    126 If you want to press F7 or Ctrl F7 to build  library or binary ..., be sure configurate dsss.conf first, SciTE4D just find the dsss.conf and pass command to DSSS. 
     713 Include path configuration 
     72 
     73open ..\scite4d\SciTEGlobal.properties, modify seatd.global.include to fit your specific libraries path. 
     74 
     75The global include path is supposed to be set in scite4d\SciTEGlobal.properties, the first line contain the include paths for libraries that all of your projects use (like Phobos or Tango). It is a list of paths separated by ';', for example:  
     76 
     77seatd.global.include=c:\dmd\src\phobos;c:\dmd\tango 
     78 
     79To change it, modify the line above accordingly and include it in your user options file.  
     80 
     814 building method Configuration 
     82 
     83Open scite4d\ybud.conf, modified the make method to fit your needs. 
     84 
     85The default make is Windows port of GNU make(mingw32-make.exe): 
     86 
     87make=mingw32-make 
     88 
     89The default Makefile name is "Makefile": 
     90 
     91makefile=Makefile 
     92 
     93 
     94the default Windows bat file name is build.bat: 
     95 
     96batfile=build.bat 
     97 
     98You can modified it e.g. "building.bat" to fit you needs. 
     99 
     100 
     101I recommend you that using dsss to build library, using GNU make to build binary. 
     102 
     103 
     1045 Click ..\scite4d\Sc1.exe to start program 
     105 
    127106  
    128107Enjoy :) 
     108 
     109 
     110== Examples == 
     111 
     1121 GNU make example 
     113 
     114Open ..\scite4d\examples\makefile\test.d 
     115press F7 (or Ctrl+F7) to build test.exe 
     116Or press Ctrl+F5 to run test.d directly 
     117 
     1182 Windows bat example 
     119 
     120Open ..\scite4d\examples\bat\test.d 
     121press F7 (or Ctrl+F7) to build test.exe 
     122Or press Ctrl+F5 to run test.d directly 
     123 
     1243   dsss example (If you have dsss installed) 
     125 
     126Open ..\scite4d\examples\dsss\test.d 
     127press F7 (or Ctrl+F7) to build test.exe 
     128Or press Ctrl+F5 to run test.d directly 
    129129     
    130130 
     
    168168 
    169169 
    170 SciTE4D 0.12 released. 
    171     Alt+F7 compile minid module 
    172     Alt+F5 run minid module 
     170SciTE4D 0.15 released. 
     171    up to date with DMD 1.027 and Tango 0.99.5 
     172    added Ctrl+F5 to run "dmd -run current.d args..." 
     173    added Makefile support 
     174    added build.bat support(Windows) 
     175    added dsss build exampe, bat build example, Makefile build exampe. 
     176 
     177 
    173178     
    174179 
     
    197202    Ctrl + Alt + F1 ËÑË÷ÔÚÏßMSDN, ÔÚÓõœ¹ØÓÚWindows API±à³Ìʱ±ÈœÏÓÐÓà
    198203 
    199     F7 Debugģʜ±àÒë 
    200  
    201     Ctrl + F7 releaseģʜ±àÒë 
    202  
    203     Ctrl + Alt + Shift + D ÎĵµÉú³É 
    204  
    205     Ctrl + Alt + Shift + T ÔËÐе¥Ôª²âÊÔ 
     204    F7 Debugģʜ±àÒë (dsss) 
     205 
     206    Ctrl + F7 releaseģʜ±àÒë (dsss) 
     207 
     208    F5 ÔËÐÐÉú³ÉµÄexe 
     209 
     210    Ctrl + F5 Ö±œÓÔËÐÐ.dÎÄŒþ 
     211 
     212    Ctrl + Alt + Shift + D ÎĵµÉú³É (dsss) 
     213 
     214    Ctrl + Alt + Shift + T ÔËÐе¥Ôª²âÊÔ (dsss) 
    206215 
    207216    Alt + D µ¯³öÉùÃ÷Áбí 
     
    211220    F12 Žò¿ª¹â±êËùÔÚ±êʶ·û¶šÒåËùÔÚÎÄŒþ£¬²¢¹ö¶¯µœËùÔÚÐР
    212221 
    213      
    214     Ô­ÀŽ http://bbs.yidabu.com ÔÚ±àÒë¿âʱÏÈÐŽÒ»žöbat ÎÄŒþµ÷ÓÃdsss±àÒë, ±àÒëʱҪÇл»µœ¿âËùÔÚÎÄŒþŒÐ, µã»÷batÎÄŒþœøÐбàÒë 
     222    Ö§³ÖÓÃbatÎÄŒþ±àÒë 
     223 
     224    Ö§³ÖÓÃdsss±àÒë 
     225 
     226    Ö§³ÖÓÃmake±àÒë 
     227     
     228    ÈýÖÖ±àÒë·œ·š×ÜÓÐÒ»ÖÖÄã×îÖÓ°®×îÉó€µÄ. Äã¿ÉÒÔÓÐʱÓÃbat, ÓÐÓÃʱmake, ±àÒë¿âʱÓÃdsss, Ò»µãÎÊÌâҲûÓÐ. 
     229 
     230    ÍÆŒö±àÒë¿âÓÃdsss, ±àÒëbinary ÓÃmake, ±àÒëŒòµ¥³ÌÐòÒ²¿ÉÒÔÓà Windows batÎÄŒþ. 
     231 
     232 
     233     
     234    Ô­ÀŽ ÔÚ±àÒë¿âʱÏÈÐŽÒ»žöbat ÎÄŒþµ÷ÓÃdsss±àÒë, ±àÒëʱҪÇл»µœ¿âËùÔÚÎÄŒþŒÐ, µã»÷batÎÄŒþœøÐбàÒë 
    215235    ±àÒëºÃºóÓÖÇл»µœ±àÒëÆ÷, Èç¹ûÒª±àÒë¶àžö¿â, »¹ÒªÐ޶àžöbatÎÄŒþ, ±ÈœÏÂé·³.  
    216236     
     
    243263    ÕâŸÍÊÇ SciTE£¬Ç¿Žó£¬ŒòÒ×£¬ÇáÇÉŒ¯ÓÚÒ»ÉíµÄµÄ³¬Œ¶ÎıŸ±àŒ­Æ÷¡£ 
    244264 
     265    4 ³ÌÐòÔ±µÄ±àŒ­Æ÷VIMÈçºÎ 
     266    Èç¹ûŸ«ÍšVIM, ¿ÉÒÔÓÃVIMÀޱàÐŽD³ÌÐòÒ²ºÜÊʺÏ, µ«VIMµÄÅäÖÃŒ°Ñ§Ï°±ÈSCITEÒªžŽÔӵöà. ÎÒœ«ÀŽÒ²Ðí»ážÄÓÃVIMÀŽÐŽDŽúÂë 
     267     
     268 
    245269 
    246270== dÓïÑÔ±àŒ­Æ÷SciTE4DµÄÏÂÔØºÍ°²×° == 
     
    262286    2   Žò¿ª scite4d\SciTEGlobal.propertiesÎÄŒþ, ±àŒ­µÚÒ»ÏîÅäÖÃ: 
    263287     
    264     °ÑÀàËÆÏÂÃæµÄ·Ÿ¶ÐޞijÉÄãµÄʵŒÊ¿âÎÄŒþ·Ÿ¶: 
    265      
    266     {{{ 
     288    °ÑÀàËÆÏÂÃæµÄ·Ÿ¶ÐޞijÉÄãµÄʵŒÊ¿âÎÄŒþ·Ÿ¶,¶àžö·Ÿ¶ÓÃ;·Öžô,ÕâÃŽ×öÊÇΪÁ˺¯ÊýÃû×Ô¶¯µŒºœµœ¶šÒ厊,Èç¹ûÄã²»ÓÃÕâžö¹ŠÄܿɲ»¹ÜÕâÏî: 
     289     
    267290        seatd.global.include=D:\d\dmd\src\phobos;D:\d\dmd\src\other;D:\d\dmd\import;D:\d\dmd\tango 
    268     }}} 
    269      
    270      
    271     Ò»Œü±àÒë»ùÓÚDSSS, ÄãÒªÔ€ÏÈÐŽºÃdsss.confÎÄŒþ, ¶šÒåºÃdebugflagsºÍreleaseflags¡£ 
    272     ÌØ±ðÊDZàÒë¿âʱ±ÈœÏ·œ±ã£¬ Žò¿ª¿âÀïµÄÈÎÒâÎÄŒþ£¬ ŸÍ¿ÉʵÏÖÒ»Œü±àÒë¡£ 
    273      
     291     
     292    Ò»Œü±àÒë»ùÓÚdsss.conf »òÕß Makefile, »òÕßbuild.bat, ÔÚ°ŽF7 ±àÒë֮ǰ, ÄãÒªÔ€ÏÈÐŽºÃÉÏÃæÈýžöÎÄŒþÖÐµÄÆäÖÐÒ»žö. 
     293 
     294    Èç¹ûÊÇdsss.conf, ¶šÒåºÃdebugflagsºÍreleaseflags, ŸÍ¿ÉÒÔ°Ñdebug±àÒëºÍrelease±àÒë×Ô¶¯Çø·Ö¿ªÀŽ. 
     295 
     296    3   Žò¿ª scite4d\ybud.conf ¿ÉÒÔÐÞžÄÄãµÄ±àÒëÅäÖÃ, ±ÈÈç, ÄãµÄmake²»ÊÇmingw32-make.exe,ŸÍ°Ñ: 
     297    make=mingw32-make 
     298 
     299    žÄ³ÉÈçÏ»òÆäËû: 
     300    make=make 
     301  
     302     
     303    4   ÊŸÀý 
     304    scite4d\examplesÏ·ֱðÓÐMakefile,build.bat, dsss.conf±àÒëÅäÖÃÊŸÀý, ¶ŒŸ­²âÊÔÍš¹ý, Äã¿ÉÒԲοŒÒ»ÏÂ. 
    274305     
    275306    ÄãÓОüºÃµÄSciTE4DÉèÖÃ, ²»·ÁÔÚÕâÀïºÍŽóŒÒ·ÖÏí: 
  • tools/scite4d/ybud.conf

    r129 r130  
    1 # make binary name, e.g. make, mingw32-make 
    2 # comment this if you never use make 
     1# comment line begin wiht # 
     2# make name, e.g. make, mingw32-make 
     3# comment next line if you never use make 
    34make=mingw32-make 
    45 
    5 # Makefile name, default is Makefil
     6# default value of Makefile nam
    67# comment next line if you never use make 
    78makefile=Makefile