1- *dbext.txt* For Vim version 6.0. Last change: Mon Apr 24 2006 9:53 :37 PM
1+ *dbext.txt* For Vim version 6.0. Last change: Wed Jun 14 2006 8:35 :37 AM
22
33
44 VIM REFERENCE MANUAL
77 David Fishburn <fishburn@ianywhere.com>
88
99 Database extension plugin (dbext.vim) manual
10- dbext.vim version 3.00
10+ dbext.vim version 3.50
1111
1212For instructions on installing this file, type
1313 :help add-local-help
@@ -25,6 +25,7 @@ SourceForge: $Revision: 1.23 $
2525 3.1 Displaying Results | dbext-configure-results |
2626 3.2 Script Variables | dbext-configure-variables |
2727 3.3 Database Specific Options | dbext-configure-options |
28+ 3.4 DB2 Modes | dbext-configure-db2 |
28294. Mappings and commands | dbext-mappings |
29305. Adding new database types | dbext-newdb |
30316. Prompting for input parameters | dbext-prompting |
@@ -52,6 +53,33 @@ SourceForge: $Revision: 1.23 $
5253------------------------------------------------------------------------------
5354What's New *dbext-new*
5455
56+ Version 3.50
57+
58+ New Features
59+ ------------
60+ - g:dbext_default_inputdialog_cancel_support = 0 will prevent
61+ inputdialog from providing a cancel option. This works around
62+ a Vim7 bug. dbext will automatically detect this and set the
63+ option the first time it is encountered.
64+ - Changed the order of some of the text in the dialog boxes to
65+ make them more readable when using the console version of Vim.
66+ - dbext can parse SQL statements and prompt the user to replace
67+ variables with values prior to sending the statement to the database
68+ to be executed. This is useful for testing SQL which is embedded
69+ in your code without having to manually replace variables and string
70+ concatentation. A new identifier (the until flag) allows you to
71+ specify the beginning of a string and what to prompt for until a
72+ finishing string. This makes it more flexible for you to configure
73+ what you would like prompting for when looking for variables.
74+
75+ Bug Fixes
76+ ------------
77+ - DBPromptForBufferParameters can report "E180: Invalid complete value: -1"
78+ if running the console version of Vim. dbext will detect this problem
79+ and automatically set g:dbext_default_inputdialog_cancel_support = 0 to
80+ work around this Vim7 bug.
81+
82+
5583Version 3.00
5684
5785 New Features
@@ -341,6 +369,17 @@ Version 2.00
341369 1 - Always prompt for variables
342370 0 - Ask if you want to (if variables are found)
343371 -1 - Never prompt for variables >
372+ dbext_default_stop_prompt_for_variables
373+ < - This is used internally by dbext. Each time a query is executed
374+ and the user is prompted for variables, if you press "Ok" without
375+ entering anything, you are prompted asking whether you want to:
376+ 1. Skip the replacement for this string
377+ 2. Replace it with a blank
378+ 3. Stop prompting for just this query
379+ 4. Never prompt for variables (including subsequent queries)
380+ 5. Abort the query and do NOT execute it
381+ - If option 3 is chosen, dbext sets this variable and resets it for
382+ the next query. >
344383 dbext_default_display_cmd_line
345384< - When the command is run, the results are displayed in the Result
346385 buffer, setting display_cmd_line = 1, will also display the command
@@ -418,8 +457,9 @@ Version 2.00
418457 :let g:dbext_default_history_max_entry = 4096
419458 dbext_default_dict_show_owner
420459< - When creating a dictionary of tables, procedures and views
421- the owner name can also be included. The default is enabled,
422- to disable add the following to your vimrc: >
460+ the owner name can also be included. The omni sql complete
461+ plugin uses this setting. The default is enabled, to disable
462+ add the following to your vimrc: >
423463 :let g:dbext_default_dict_show_owner = 0
424464<
425465 Buffer variables
@@ -567,12 +607,30 @@ Version 2.00
567607 \ "set tab off\n\n"
568608 dbext_default_ORA_cmd_terminator = ";\nquit;"
569609 dbext_default_ORA_cmd_options = '-S'
610+ dbext_default_DB2_use_db2batch = 0
570611 dbext_default_DB2_bin = 'db2batch'
571612 dbext_default_DB2_cmd_header = ''
572- dbext_default_DB2_cmd_terminator = ''
613+ dbext_default_DB2_cmd_terminator = '; '
573614 dbext_default_DB2_cmd_options = '-q del -s off'
615+ dbext_default_DB2_db2cmd_bin = 'db2cmd'
616+ dbext_default_DB2_db2cmd_cmd_options = '-c -w -i -t db2 -s'
574617<
575618
619+ 3.4 DB2 Modes *dbext-configure-db2*
620+ DB2 provides two different binaries to execute commands: db2batch, db2cmd.
621+ The dbext plugin supports both. To change modes for the current buffer
622+ you can execute this command: >
623+ :DBSetOption DB2_use_db2batch = 1
624+ :DBSetOption DB2_use_db2batch = 0
625+ <
626+ To change on a permenant basis add the following to your vimrc: >
627+ let dbext_default_DB2_use_db2batch = 1
628+ <
629+ Each has their own advantages or disadvantages. Depending on your
630+ platform you may only have access to one or the other. Please
631+ try both to see which fits your needs.
632+
633+
576634------------------------------------------------------------------------------
5776354. Mappings and commands *dbext-mappings*
578636
@@ -866,6 +924,22 @@ Version 2.00
866924 plugin finds more matches that expected, you can choose Cancel when prompted
867925 for the variable name, and choose Skip, to move to the next match.
868926
927+ Another type of criteria is specified. You can also use the "unitl" setting
928+ which allows you to specify the start of the string, and the everything
929+ should be replaced "until" another string. Here is an example: >
930+ SELECT * FROM Customers WHERE ID = http_variable('cust_id')
931+ <
932+ In this case, we want dbext to prompt for anything like "http_variable(...)".
933+ This can be configured using: >
934+ DBSetOption variable_def='http_varu)'
935+ <
936+ This option has special rules, and is broken down as:
937+ http_var - Look for this string
938+ u - Assume a match UNTIL
939+ ) - This string
940+ So in this case, matching "http_var" until the ")" will force dbext to
941+ prompt the user for a replacement of "http_variable('cust_id')".
942+
869943 For more information on specific filetype support see | dbext-filetypes |
870944
871945------------------------------------------------------------------------------
0 commit comments