SQLite Forum

Documentation issue
Login

Documentation issue

(1) By oneeyeman on 2025-08-01 01:45:58 [link] [source]

Hi, ALL,

In the page https://sqlite.org/lang_createindex.html, the syntax diagram is missing the index name.

Thank you.

P.S.: I don't know if the forum accepts the screenshot, but I can make one and put it somewhere...

(2) By anonymous on 2025-08-01 03:03:56 in reply to 1 [link] [source]

Works perfectly here. What browser are you using?

(4) By oneeyeman on 2025-08-01 12:12:41 in reply to 2 [link] [source]

Hi,

Works perfectly here. What browser are you using?

I'm on FF on Gentoo Linux.

Where can I put a screenshot for the review?

Thank you.

(3) By lexfiend on 2025-08-01 04:27:27 in reply to 1 [link] [source]

Seems fine to me. Here's an ASCII rendition of the relevant Pikchr diagram:

...
| 
|-> schema-name -> . ---> index-name -> ON -> ...
|                     |
\---------------------/
Are you seeing something different?

(5) By oneeyeman on 2025-08-01 12:13:47 in reply to 3 [link] [source]

Hi,

Where can I put a screenshot?

Thank you.

(6) By punkish on 2025-08-01 12:51:52 in reply to 5 [link] [source]

(7) By stephan on 2025-08-01 12:58:48 in reply to 6 [source]

(image blob)

For the record, we discourage pasting in of blobs like that because (A) they're huge and (B) they go out as emails to 2000+ forum subscribers.

Don't delete it - it's already been sent - but please (everyone) refrain from using that workaround to attaching images in this forum.

(8.1) By punkish on 2025-08-01 13:03:55 edited from 8.0 in reply to 7 [link] [source]

yea, sorry about that, but the OP's plea for posting a picture (and my own urge to experiment) proved too strong :)

I tried many different ways and encoding the image as base-64 was the only one that worked. I see (from the markdown docs for the forum) that pikchur embeds are allowed (which is what the original diagram is) but I don't know how to create one. In any case, point well noted.

edit: Would be nice actually to have the ability to post pictures, but we have also managed without it quite well far

(9) By stephan on 2025-08-01 13:11:24 in reply to 8.1 [link] [source]

edit: Would be nice actually to have the ability to post pictures,

It's definitely a sorely-missed feature by most folks (myself included now and then), but it's one the Fossil devs (primarily myself and drh) have repeatedly actively rejected. Fossil's /chat app supports them, so we're not 100% averse to them, but we're concerned about bandwidth usage, moderation effort, and long-term repository sizes if the general public were able to easily upload arbitrary screenshots.

No harm done, but (everyone!) please, in this forum, don't use that otherwise perfectly legitimate approach to shoehorning in screenshots.

(13) By stephan on 2025-08-01 13:56:33 in reply to 7 [link] [source]

For the record, we discourage...

Also for the record, that's finally been documented in the new FAQ page, reachable via the "About" link at the top of this site.

New suggestions for FAQ entries are welcomed1, especially if they include links to relevant forum posts and/or SQLite doc pages. Just post them here in the forum.


  1. ^ Keeping in mind that the "F" in FAQ means "frequently" or "repetitively".

(10) By drh on 2025-08-01 13:46:03 in reply to 1 [link] [source]

I don't know if the forum accepts the screenshot

It does not. That is a deliberate design decision. What I have found is that providing the ability to attach images encourages low-information users to attach hi-res screenshots of their entire desktop and then ask "Why doesn't this work?". And then this Forum is compelled to store those multi-megabyte screenshots for the next 25 years or so. Multiple multi-megabyte images per day begins to add up.

So, no images. Use your words.

If you have access to some other website where you can post your screenshot, you can do so and then include a link in your post. But this Forum does not want to store your screenshot for 25 years.

(11) By punkish on 2025-08-01 13:49:31 in reply to 10 [link] [source]

If you have access to some other website where you can post your screenshot, you can do so and then include a link in your post. But this Forum does not want to store your screenshot for 25 years.

Fwiw, I tried linking to an image on imgur but just couldn't get it to work

(14) By lexfiend on 2025-08-01 14:57:08 in reply to 11 [link] [source]

That link came through fine. Just don't expect the image to be inlined, as that just encourages others to post their 8K screenshots while asking for help.

Also, I see index-name clearly near the center of the screenshot, so I'm not sure why you're claiming you don't see it.

(15) By punkish on 2025-08-01 15:03:04 in reply to 14 [link] [source]

Also, I see index-name clearly near the center of the screenshot, so I'm not sure why you're claiming you don't see it.

To be clear, the you're above is oneeyeman, not me, the inadvertent experimenter with image-posting. I see the index-name just fine.

Just don't expect the image to be inlined, as that just encourages others to post their 8K screenshots while asking for help.

Also, per the newly minted FAQ, it is perfectly ok to link and inline the image as long as it is hosted somewhere other than sqlite.org servers (or so I understand)

(16) By lexfiend on 2025-08-01 15:10:21 in reply to 15 [link] [source]

Ah sorry, posting on a bus ride home, not the best place to follow up on a surprisingly long thread. :)

(17) By chrisjlocke1 on 2025-08-01 16:00:47 in reply to 11 [link] [source]

This has always worked for me in the past. Try this markup

an image

You have to link to an individual image, and not an album.

In imgur, simply paste the image in, let it upload, then copy the link. It should link to a PNG

(12) By stephan on 2025-08-01 13:50:43 in reply to 10 [link] [source]

... for the next 25 years or so

Just to add some context for those who might not know: the SQLite project is pledged to be supported through at least its 50th anniversary in 2050. i.e. 25 years from now.