Add DATE_ROUND() function to docs (#254)

* Fix anchor link behavior
* improve button "show example result"
* clean up whitespace related to examples

Author: Simran-B

3.3/administration-arangosh-output.md

@@ -7,6 +7,7 @@ ArangoDB Shell Output
 
 The ArangoDB shell will print the output of the last evaluated expression
 by default:
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}    
     @startDocuBlockInline lastExpressionResult
     @EXAMPLE_ARANGOSH_OUTPUT{lastExpressionResult}
@@ -15,8 +16,10 @@ by default:
     @endDocuBlock lastExpressionResult
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}    
+
 In order to prevent printing the result of the last evaluated expression,
 the expression result can be captured in a variable, e.g.
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline lastExpressionResultCaptured
     @EXAMPLE_ARANGOSH_OUTPUT{lastExpressionResultCaptured}
@@ -25,8 +28,10 @@ the expression result can be captured in a variable, e.g.
     @endDocuBlock lastExpressionResultCaptured
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 There is also the `print` function to explicitly print out values in the
 ArangoDB shell:
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline printFunction
     @EXAMPLE_ARANGOSH_OUTPUT{printFunction}
@@ -35,8 +40,10 @@ ArangoDB shell:
     @endDocuBlock printFunction
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 By default, the ArangoDB shell uses a pretty printer when JSON documents are
 printed. This ensures documents are printed in a human-readable way:
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline usingToArray
     @EXAMPLE_ARANGOSH_OUTPUT{usingToArray}
@@ -48,6 +55,7 @@ printed. This ensures documents are printed in a human-readable way:
     @endDocuBlock usingToArray
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 While the pretty-printer produces nice looking results, it will need a lot of
 screen space for each document. Sometimes a more dense output might be better.
 In this case, the pretty printer can be turned off using the command

3.3/administration-arangosh.md

@@ -42,6 +42,7 @@ server after the password was entered.
 
 To change the current database after the connection has been made, you
 can use the `db._useDatabase()` command in arangosh:
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline shellUseDB
     @EXAMPLE_ARANGOSH_OUTPUT{shellUseDB}
@@ -53,6 +54,7 @@ can use the `db._useDatabase()` command in arangosh:
     @endDocuBlock shellUseDB
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 To get a list of available commands, arangosh provides a *help()* function.
 Calling it will display helpful information.
 
@@ -66,6 +68,7 @@ be used for switching to a different database and managing collections inside th
 current database.
 
 For a list of available methods for the *db* object, type 
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}    
     @startDocuBlockInline shellHelp
     @EXAMPLE_ARANGOSH_OUTPUT{shellHelp}
@@ -74,8 +77,10 @@ For a list of available methods for the *db* object, type
     @endDocuBlock shellHelp
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 you can paste multiple lines into arangosh, given the first line ends with an
 opening brace:
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline shellPaste
     @EXAMPLE_ARANGOSH_OUTPUT{shellPaste}

3.3/administration-configuration-general-arangod.md

@@ -192,6 +192,7 @@ generator and the Mersenne Twister.
 
 
 ### Enable/disable authentication
+
 {% docublock server_authentication %}
 
 ### JWT Secret
@@ -224,6 +225,7 @@ The default value is *false*.
 domain sockets.
 
 ### Enable/disable authentication for system API requests only
+
 {% docublock serverAuthenticateSystemOnly %}
 
 
@@ -329,9 +331,11 @@ to the web interface (/_admin/aardvark) and related areas.
 Sessions are only used when authentication is turned on.
 
 ### Foxx queues
+
 {% docublock foxxQueues %}
 
 ### Foxx queues poll interval
+
 {% docublock foxxQueuesPollInterval %}
 
 ### Directory
@@ -376,14 +380,17 @@ in a specific state on startup. the options for this value are:
 
 
 ### Journal size
+
 {% docublock databaseMaximalJournalSize %}
 
 
 ### Wait for sync
+
 {% docublock databaseWaitForSync %}
 
 
 ### Force syncing of properties
+
 {% docublock databaseForceSyncProperties %}
 
 

3.3/administration-managing-users-in-arangosh.md

@@ -74,6 +74,7 @@ to grant the access rights for one or more databases using
 [grantDatabase](#grant-database).
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_02_saveUser
     @EXAMPLE_ARANGOSH_OUTPUT{USER_02_saveUser}
@@ -82,6 +83,7 @@ to grant the access rights for one or more databases using
     @endDocuBlock USER_02_saveUser
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 Grant Database
 --------------
 
@@ -145,6 +147,7 @@ database.
 **Note**: this function will not work from within the web interface
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_03_replaceUser
     @EXAMPLE_ARANGOSH_OUTPUT{USER_03_replaceUser}
@@ -153,6 +156,7 @@ database.
     @endDocuBlock USER_03_replaceUser
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 Update
 ------
 
@@ -173,6 +177,7 @@ or given in a wrong format, or if the specified user cannot be found in the
 database.
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_04_updateUser
     @EXAMPLE_ARANGOSH_OUTPUT{USER_04_updateUser}
@@ -181,6 +186,7 @@ database.
     @endDocuBlock USER_04_updateUser
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 isValid
 -------
 
@@ -194,6 +200,7 @@ Each call to this function is penalized by the server sleeping a random
 amount of time.
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_05_isValidUser
     @EXAMPLE_ARANGOSH_OUTPUT{USER_05_isValidUser}
@@ -202,6 +209,7 @@ amount of time.
     @endDocuBlock USER_05_isValidUser
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 Remove
 ------
 
@@ -215,6 +223,7 @@ the database.
 This method will fail if the user cannot be found in the database.
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_07_removeUser
     @EXAMPLE_ARANGOSH_OUTPUT{USER_07_removeUser}
@@ -223,6 +232,7 @@ This method will fail if the user cannot be found in the database.
     @endDocuBlock USER_07_removeUser
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 Document
 --------
 
@@ -235,6 +245,7 @@ The user name must be specified in *user*.
 This method will fail if the user cannot be found in the database.
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_04_documentUser
     @EXAMPLE_ARANGOSH_OUTPUT{USER_04_documentUser}
@@ -243,6 +254,7 @@ This method will fail if the user cannot be found in the database.
     @endDocuBlock USER_04_documentUser
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 All
 ---
 
@@ -251,6 +263,7 @@ All
 Fetches all existing ArangoDB users from the database.
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_06_AllUsers
     @EXAMPLE_ARANGOSH_OUTPUT{USER_06_AllUsers}
@@ -259,6 +272,7 @@ Fetches all existing ArangoDB users from the database.
     @endDocuBlock USER_06_AllUsers
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 Reload
 ------
 
@@ -271,6 +285,7 @@ cached after that. When users get added or deleted, a cache flush is done
 automatically, and this can be performed by a call to this method.
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_03_reloadUser
     @EXAMPLE_ARANGOSH_OUTPUT{USER_03_reloadUser}
@@ -293,6 +308,7 @@ the collection name.
 This method will fail if the user cannot be found in the database.
 
 *Examples*
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline USER_05_permission
     @EXAMPLE_ARANGOSH_OUTPUT{USER_05_permission}

3.3/appendix-deprecated-actions-html-example.md

@@ -32,6 +32,7 @@ ArangoDB is stored in a collection *_routing*. Each entry in this collections
 describes how to deal with a particular request path.
 
 For the above example, add the following document to the _routing collection:
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline HTML_01_routingCreateHtml
     @EXAMPLE_ARANGOSH_OUTPUT{HTML_01_routingCreateHtml}
@@ -48,8 +49,10 @@ For the above example, add the following document to the _routing collection:
     @endDocuBlock HTML_01_routingCreateHtml
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 In order to activate the new routing, you must either restart the server or call
 the internal reload function.
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline HTML_02_routingReload
     @EXAMPLE_ARANGOSH_OUTPUT{HTML_02_routingReload}
@@ -58,9 +61,11 @@ the internal reload function.
     @endDocuBlock HTML_02_routingReload
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 Now use the browser and access http:// localhost:8529/hello/world
 
 You should see the *Hello World* in our browser:
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline HTML_03_routingCurlHtml
     @EXAMPLE_ARANGOSH_RUN{HTML_03_routingCurlHtml}
@@ -253,6 +258,7 @@ Remember that the more specific match wins.
   right.
 
 Consider the following definitions
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline HTML_04_routingCreateMultiPath
     @EXAMPLE_ARANGOSH_OUTPUT{HTML_04_routingCreateMultiPath}
@@ -273,7 +279,9 @@ Consider the following definitions
     @endDocuBlock HTML_04_routingCreateMultiPath
 {% endarangoshexample %}
 {% include arangoshexample.html id=examplevar script=script result=result %}
+
 Then
+
 {% arangoshexample examplevar="examplevar" script="script" result="result" %}
     @startDocuBlockInline HTML_05_routingGetMultiPath
     @EXAMPLE_ARANGOSH_RUN{HTML_05_routingGetMultiPath}