Support API docs having multiline code segments.

[suhothayan]

Purpose

Improve API documentation readability. This allows docs having

multi 
line content 

[codecov-io]

Codecov Report

Merging #1430 into master will decrease coverage by 0.02%.
The diff coverage is n/a.

@@             Coverage Diff              @@
##             master    #1430      +/-   ##
============================================
- Coverage     67.57%   67.54%   -0.03%     
  Complexity       41       41              
============================================
  Files           634      634              
  Lines         26718    26737      +19     
  Branches       4219     4222       +3     
============================================
+ Hits          18055    18060       +5     
- Misses         6892     6906      +14     
  Partials       1771     1771

Impacted Files	Coverage Δ	Complexity Δ
...e/util/statistics/memory/ObjectSizeCalculator.java	73.58% <0%> (-2.52%)	0% <0%> (ø)
...y/api/execution/query/output/stream/UpdateSet.java	24.44% <0%> (-1.14%)	0% <0%> (ø)
...e/src/main/java/io/siddhi/core/util/Scheduler.java	81.64% <0%> (-0.53%)	0% <0%> (ø)
...core/src/main/java/io/siddhi/core/table/Table.java	27.54% <0%> (-0.48%)	0% <0%> (ø)
.../io/siddhi/core/util/snapshot/SnapshotService.java	71.63% <0%> (-0.42%)	0% <0%> (ø)
...nt/stream/holder/SnapshotableStreamEventQueue.java	75.91% <0%> (-0.4%)	0% <0%> (ø)
...ore/util/parser/helper/DefinitionParserHelper.java	74.48% <0%> (+0.05%)	0% <0%> (ø)	⬇️
...ore/table/record/AbstractQueryableRecordTable.java	85.93% <0%> (+0.05%)	0% <0%> (ø)	⬇️
...siddhi/core/query/input/ProcessStreamReceiver.java	86.17% <0%> (+0.14%)	0% <0%> (ø)	⬇️
...o/siddhi/core/aggregation/IncrementalExecutor.java	80.46% <0%> (+0.15%)	0% <0%> (ø)	⬇️
... and 6 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 174214a...8a2c150. Read the comment docs.