[ 
https://issues.apache.org/jira/browse/CASSANDRA-4879?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Kristine Hahn updated CASSANDRA-4879:
-------------------------------------

    Description: 
https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile doesn't 
include the new create keyspace syntax or the collections. I could update the 
CQL.textile, like last time, and would like to save Dev from doing it. I'm 
trying to get info from tickets, but not finding some things, like how you 
enter multiple DC values replication factors. No tab complete. 

BNR-like formatting needs to be replaced, right?, because the brackets now have 
literal meaning. In the datastax.com docs, I test-applied this custom 
formatting to commands and it seems ok: Uppercase means literal (lowercase 
nonliteral), italics mean optional, the | symbol means OR, ... means 
repeatable. The ... in italics doesn't strictly explain things like nested 
[...] does, but it's easier on the eyes and loosely understandable. Any doubt 
could be erased by examples, I think.

  was:
https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile doesn't 
include the new create keyspace syntax or the collections. I could update the 
CQL.textile, like last time, and would like to save Dev from doing it. I'm 
trying to get info from tickets, but not finding some things, like how you 
enter multiple DC values replication factors. No tab complete. 

BNR-like formatting needs to be replaced, right?, because the brackets now have 
literal meaning. In the datastax.com docs, I test-applied this custom 
formatting to commands and it seems ok: Uppercase means literal (lowercase 
nonliteral), italics mean optional, the | symbol means OR, ... means 
repeatable. The ... doesn't completely explain optional like [] does, but any 
doubt could be erased by examples.

    
> CQL help in trunk/doc/cql3/CQL.textile outdated
> -----------------------------------------------
>
>                 Key: CASSANDRA-4879
>                 URL: https://issues.apache.org/jira/browse/CASSANDRA-4879
>             Project: Cassandra
>          Issue Type: Bug
>    Affects Versions: 1.2.0 beta 1
>            Reporter: Kristine Hahn
>            Assignee: Sylvain Lebresne
>              Labels: documentation
>
> https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile doesn't 
> include the new create keyspace syntax or the collections. I could update the 
> CQL.textile, like last time, and would like to save Dev from doing it. I'm 
> trying to get info from tickets, but not finding some things, like how you 
> enter multiple DC values replication factors. No tab complete. 
> BNR-like formatting needs to be replaced, right?, because the brackets now 
> have literal meaning. In the datastax.com docs, I test-applied this custom 
> formatting to commands and it seems ok: Uppercase means literal (lowercase 
> nonliteral), italics mean optional, the | symbol means OR, ... means 
> repeatable. The ... in italics doesn't strictly explain things like nested 
> [...] does, but it's easier on the eyes and loosely understandable. Any doubt 
> could be erased by examples, I think.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to