code review 4029047: misc/vim: Document better syntax sync parameter

misc/vim: Document better syntax sync parameter

Forcing the synchronization of 500 lines is both slower and
less precise than searching for a known sync point.
Unfortunately, though, the way to synchronize correctly is
using the grouphere instruction, which has a bug.

I've already proposed the fix to Vim, so future releases
should have this working.  We can continue using the 500 lines
syncing for now.

This change just documents the proper way to sync.

[niemeyer, 2011-01-27 23:15:23]

Hello adg (cc: golang-dev@googlegroups.com),

I'd like you to review this change.

[dsymonds, 2011-01-27 23:31:43]

What about ^package and ^import?

[niemeyer, 2011-01-27 23:38:41]

> What about ^package and ^import?

Both of these are necessarily at the start of the file, so we may
as well go all the way up rather than risking an incorrect match.

[adg, 2011-02-01 00:11:08]

LGTM

[adg, 2011-02-01 00:12:52]

*** Submitted as http://code.google.com/p/go/source/detail?r=7b6f4749ccbb ***

misc/vim: Document better syntax sync parameter

Forcing the synchronization of 500 lines is both slower and
less precise than searching for a known sync point.
Unfortunately, though, the way to synchronize correctly is
using the grouphere instruction, which has a bug.

I've already proposed the fix to Vim, so future releases
should have this working.  We can continue using the 500 lines
syncing for now.

This change just documents the proper way to sync.

R=adg, dsymonds
CC=golang-dev
http://codereview.appspot.com/4029047

Committer: Andrew Gerrand <adg@golang.org>