Skip to content

Commit 5a94f8e

Browse files
committed
Remove {{{ vim folding }}}
Was dicussed recently at https://externals.io/message/110028 but received no feedback. Let's try this...
1 parent f1d0ead commit 5a94f8e

File tree

475 files changed

+14464
-22520
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

475 files changed

+14464
-22520
lines changed

CODING_STANDARDS.md

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -272,15 +272,15 @@ use these rules.
272272
1. Extensions should be well tested using `*.phpt` tests. Read about that at
273273
[qa.php.net](https://qa.php.net/write-test.php) documentation.
274274

275-
## Documentation and folding hooks
275+
## Documentation
276276

277277
In order to make sure that the online documentation stays in line with the code,
278278
each user-level function should have its user-level function prototype before it
279279
along with a brief one-line description of what the function does. It would look
280280
like this:
281281

282282
```c
283-
/* {{{ proto int abs(int number)
283+
/* proto int abs(int number)
284284
Returns the absolute value of the number */
285285
PHP_FUNCTION(abs)
286286
{
@@ -289,12 +289,6 @@ PHP_FUNCTION(abs)
289289
/* }}} */
290290
```
291291

292-
The `{{{` symbols are the default folding symbols for the folding mode in Emacs
293-
and vim (`set fdm=marker`). Folding is very useful when dealing with large files
294-
because you can scroll through the file quickly and just unfold the function you
295-
wish to work on. The `}}}` at the end of each function marks the end of the
296-
fold, and should be on a separate line.
297-
298292
The `proto` keyword there is just a helper for the `doc/genfuncsummary` script
299293
which generates a full function summary. Having this keyword in front of the
300294
function prototypes allows us to put folds elsewhere in the code without
@@ -303,7 +297,7 @@ messing up the function summary.
303297
Optional arguments are written like this:
304298

305299
```c
306-
/* {{{ proto object imap_header(int stream_id, int msg_no [, int from_length [, int subject_length [, string default_host]]])
300+
/* proto object imap_header(int stream_id, int msg_no [, int from_length [, int subject_length [, string default_host]]])
307301
Returns a header object with the defined parameters */
308302
```
309303

0 commit comments

Comments
 (0)