postgresql/doc/src/sgml
Bruce Momjian 81186865fe Joe Conway wrote:
> Hannu Krosing wrote:
 >
 >> It seems that my last mail on this did not get through to the list
 >> ;(
 >>
 >> Please consider renaming the new builtin function
 >> split(text,text,int)
 >>
 >> to something else, perhaps
 >>
 >> split_part(text,text,int)
 >>
 >> (like date_part)
 >>
 >> The reason for this request is that 3 most popular scripting
 >> languages (perl, python, php) all have also a function with similar
 >> signature, but returning an array instead of single element and the
 >> (optional) third argument is limit (maximum number of splits to
 >> perform)
 >>
 >> I think that it would be good to have similar function in (some
 >> future release of) postgres, but if we now let in a function with
 >> same name and arguments but returning a single string instead an
 >> array of them, then we will need to invent a new and not so easy to
 >> recognise name for the "real" split function.
 >>
 >
 > This is a good point, and I'm not opposed to changing the name, but
 > it is too bad your original email didn't get through before beta1 was
 >  rolled. The change would now require an initdb, which I know we were
 >  trying to avoid once beta started (although we could change it
 > without *requiring* an initdb I suppose).
 >
 > I guess if we do end up needing an initdb for other reasons, we
 > should make this change too. Any other opinions? Is split_part an
 > acceptable name?
 >
 > Also, if we add a todo to produce a "real" split function that
 > returns an array, similar to those languages, I'll take it for 7.4.

No one commented on the choice of name, so the attached patch changes
the name of split(text,text,int) to split_part(text,text,int) per
Hannu's recommendation above. This can be applied without an initdb if
current beta testers are advised to run:

   update pg_proc set proname = 'split_part' where proname = 'split';

in the case they want to use this function. Regression and doc fix is
also included in the patch.

Joe Conway
2002-09-12 00:21:25 +00:00
..
ref Remove pgaccess from docs; not shipping it anymore. 2002-09-07 16:49:50 +00:00
admin.sgml Move disk usage section into its own section. 2002-06-13 05:15:22 +00:00
advanced.sgml Implement SQL99 OVERLAY(). Allows substitution of a substring in a string. 2002-06-11 15:32:33 +00:00
arch-dev.sgml Deprecate 'current' for date/time input. 2001-11-21 05:53:41 +00:00
arch-pg.sgml Spell-check and markup police 2002-01-20 22:19:57 +00:00
array.sgml Add User's Guide chapters on Data Definition and Data Manipulation. 2002-08-05 19:43:31 +00:00
backup.sgml proof-reading 2001-11-28 20:49:10 +00:00
biblio.sgml Adjust spelling of article titles to match the originals, add some links. 2002-01-08 23:50:37 +00:00
bki.sgml Implement types regprocedure, regoper, regoperator, regclass, regtype 2002-04-25 02:56:56 +00:00
book-decl.sgml Add User's Guide chapters on Data Definition and Data Manipulation. 2002-08-05 19:43:31 +00:00
catalogs.sgml Code review and documentation updates for indisclustered patch. 2002-09-03 01:04:41 +00:00
charset.sgml Add Cyrillic and other encodings for encoding conversion. 2002-08-14 02:45:10 +00:00
client-auth.sgml This patch improves the "Client Authentication" section of the user's 2002-08-16 04:48:16 +00:00
compiler.sgml Make use of <email> tag for marking up email addresses. 2000-12-22 21:51:58 +00:00
contacts.sgml Update Thomas Lockhart's email address to lockhart@fourpalms.org. 2002-01-08 20:03:58 +00:00
cvs.sgml Make spelling of operating system names match official version closely. 2002-01-09 00:52:38 +00:00
datatype.sgml This patch updates the CREATE OPERATOR sgml docs for the new default 2002-08-23 02:54:18 +00:00
datetime.sgml Add Myannar Time, Iran Time variant name, and Marquesas Time. 2002-08-04 06:15:45 +00:00
ddl.sgml Fill in section on table modification. 2002-09-05 21:32:23 +00:00
developer.sgml Bunch of copy fitting and style sheet tweakage to get decent looking print 2001-10-09 18:46:00 +00:00
dfunc.sgml Add OS X link line example for external functions. 2002-08-26 23:22:47 +00:00
diskusage.sgml Fix capitalization. 2002-07-05 00:14:16 +00:00
dml.sgml Forgot to add/remove files. 2002-08-05 19:44:58 +00:00
docguide.sgml Structure reference pages consistently. Document that structure. 2002-07-28 15:22:21 +00:00
ecpg.sgml Spell-check and markup police 2002-01-20 22:19:57 +00:00
entities.sgml Forgot to add/remove files. 2002-08-05 19:44:58 +00:00
extend.sgml Replace ad-hoc insertions into pg_opclass and friends with CREATE 2002-07-30 17:34:37 +00:00
features.sgml Add IS OF type predicate. 2002-08-04 06:17:29 +00:00
filelist.sgml Remove libpq++ SGML documentation. 2002-08-22 03:17:38 +00:00
fixrtf Add option --refentry to change \keepn (keep with next paragraph) to 2001-04-20 15:50:25 +00:00
func-ref.sgml Add id field to chapter and book tags to allow output file names 1998-07-29 06:50:04 +00:00
func.sgml Joe Conway wrote: 2002-09-12 00:21:25 +00:00
geqo.sgml Spell-check and markup police 2002-01-20 22:19:57 +00:00
gist.sgml Make spelling of operating system names match official version closely. 2002-01-09 00:52:38 +00:00
history.sgml Editorial review 2002-01-07 02:29:15 +00:00
indexcost.sgml Add a bunch of pseudo-types to replace the behavior formerly associated 2002-08-22 00:01:51 +00:00
indices.sgml Change NAMEDATALEN to 64, INDEX_MAX_KEYS/MAX_FUNC_ARGS to 32, per discussion on hackers. 2002-08-13 20:40:44 +00:00
info.sgml proof-reading 2001-11-28 20:49:10 +00:00
install-win32.sgml proof-reading 2001-11-28 20:49:10 +00:00
installation.sgml Remove more references to pgaccess as a build target in docs. 2002-09-08 02:33:08 +00:00
intro.sgml Editorial review 2002-01-07 02:29:15 +00:00
jdbc.sgml Spell checking and markup additions 2002-03-22 19:20:45 +00:00
keywords.sgml Improve COPY syntax to use WITH clause, keep backward compatibility. 2002-06-20 16:00:44 +00:00
legal.sgml Update copyright to 2002. 2002-06-20 20:29:54 +00:00
libpgeasy.sgml Improve libpgeasy API for multiple result sets, add example. 2002-03-04 18:50:21 +00:00
libpgtcl.sgml Fix SGML build failure. 2002-09-03 16:21:23 +00:00
libpq.sgml Missed mention of PGPASSWORDFILE. 2002-09-05 22:09:42 +00:00
lobj.sgml Correct documention of lo_unlink return value as int, not Oid. 2002-04-18 14:28:14 +00:00
maintenance.sgml Rename command to reindexdb, for consistency. 2002-06-23 03:51:55 +00:00
Makefile Add User's Guide chapters on Data Definition and Data Manipulation. 2002-08-05 19:43:31 +00:00
manage-ag.sgml proof-reading 2001-11-28 20:49:10 +00:00
manage.sgml Change NAMEDATALEN to 64, INDEX_MAX_KEYS/MAX_FUNC_ARGS to 32, per discussion on hackers. 2002-08-13 20:40:44 +00:00
monitoring.sgml Code review for pg_locks feature. Make shmemoffset of PROCLOCK structs 2002-08-31 17:14:28 +00:00
mvcc.sgml [ Newest version of patch applied.] 2002-08-17 13:04:19 +00:00
nls.sgml Spell checking and markup additions 2002-03-22 19:20:45 +00:00
notation.sgml Copy-editing. 2001-11-23 22:06:20 +00:00
odbc.sgml Spell checking and markup additions 2002-03-22 19:20:45 +00:00
page.sgml Code review for HeapTupleHeader changes. Add version number to page headers 2002-09-02 01:05:06 +00:00
perform.sgml Tweak labeling of plan qual conditions for more consistency. 2002-03-24 17:11:37 +00:00
plperl.sgml Update docs for new stored procedure error levels. 2002-03-06 19:05:58 +00:00
plpgsql.sgml plpgsql functions can return RECORD, per Neil Conway. 2002-09-01 16:28:06 +00:00
plpython.sgml Spell checking and markup additions 2002-03-22 19:20:45 +00:00
pltcl.sgml Add a bunch of pseudo-types to replace the behavior formerly associated 2002-08-22 00:01:51 +00:00
postgres.sgml Add User's Guide chapters on Data Definition and Data Manipulation. 2002-08-05 19:43:31 +00:00
problems.sgml Spell-check and markup police 2002-01-20 22:19:57 +00:00
programmer.sgml Remove libpq++ SGML documentation. 2002-08-22 03:17:38 +00:00
protocol.sgml Spell checking and markup additions 2002-03-22 19:20:45 +00:00
pygresql.sgml Don't mark up as acronym that which is not an acronym. 2002-03-27 19:19:23 +00:00
queries.sgml Add User's Guide chapters on Data Definition and Data Manipulation. 2002-08-05 19:43:31 +00:00
query.sgml Spell-check and markup police 2002-01-20 22:19:57 +00:00
recovery.sgml Spell-check and markup police 2002-01-20 22:19:57 +00:00
refentry.sgml Accumulated fixups. 2000-03-30 22:22:41 +00:00
reference.ced Deprecate 'current' for date/time input. 2001-11-21 05:53:41 +00:00
reference.sgml Remove more references to pgaccess as a build target in docs. 2002-09-08 02:33:08 +00:00
regress.sgml Make regression tests locale-proof by setting some locale categories 2002-05-14 13:05:43 +00:00
release.sgml Update new HISTORY file for 7.3! 2002-09-04 07:16:32 +00:00
rules.sgml Change naming rule for ON SELECT rules of views: they're all just 2002-04-19 23:13:54 +00:00
runtime.sgml Fix broken markup. 2002-09-02 13:45:30 +00:00
sources.sgml Spell-check and markup police 2002-01-20 22:19:57 +00:00
spi.sgml I checked all the previous string handling errors and most of them were 2002-09-02 06:11:43 +00:00
sql.sgml Allow FOR UPDATE to appear after LIMIT/OFFSET to match MySQL syntax and as 2002-08-28 14:35:37 +00:00
standalone-install.sgml Readd test/regress/README file, this time with a well-defined and simple 2001-09-21 18:37:05 +00:00
start.sgml Change NAMEDATALEN to 64, INDEX_MAX_KEYS/MAX_FUNC_ARGS to 32, per discussion on hackers. 2002-08-13 20:40:44 +00:00
stylesheet.css Uppercase class selectors, to work with browsers that follow the standards. 2002-03-11 05:02:04 +00:00
stylesheet.dsl Add User's Guide chapters on Data Definition and Data Manipulation. 2002-08-05 19:43:31 +00:00
syntax.sgml Not sure how I fixed it the first time, but here's a fix for another 2002-08-23 04:27:19 +00:00
trigger.sgml Add a bunch of pseudo-types to replace the behavior formerly associated 2002-08-22 00:01:51 +00:00
tutorial.sgml New blood and fresh air for tutorial 2001-09-02 23:27:50 +00:00
typeconv.sgml Updates for schema features. 2002-04-25 20:14:43 +00:00
user-manag.sgml This patch improves the "Database Users and Permissions" section of 2002-08-16 04:47:43 +00:00
user.sgml Add User's Guide chapters on Data Definition and Data Manipulation. 2002-08-05 19:43:31 +00:00
version.sgml Brand 7.3. Ready for beta! 2002-09-04 07:23:04 +00:00
wal.sgml Fix another typo. 2002-09-06 20:26:00 +00:00
xaggr.sgml Editorial review 2002-01-07 02:29:15 +00:00
xfunc.sgml plpgsql functions can return RECORD, per Neil Conway. 2002-09-01 16:28:06 +00:00
xindex.sgml Replace ad-hoc insertions into pg_opclass and friends with CREATE 2002-07-30 17:34:37 +00:00
xoper.sgml Update for additional options in CREATE OPERATOR. 2002-05-11 02:09:41 +00:00
xplang.sgml Add a bunch of pseudo-types to replace the behavior formerly associated 2002-08-22 00:01:51 +00:00
xtypes.sgml Add a bunch of pseudo-types to replace the behavior formerly associated 2002-08-22 00:01:51 +00:00
y2k.sgml Update Thomas Lockhart's email address to lockhart@fourpalms.org. 2002-01-08 20:03:58 +00:00