Add support to specify multiple routes for the same function

[pc-coder]

Describe the PR
Add support to specify multiple routes for the same function

Relation issue
#460

Additional context
In the case of multiple @router comments, swagger creates routes using information only from the last comment.
This change would help us add swagger routes for each comment.

[ubogdan]

Except for the 2 comments left LTGTM.

[ubogdan]

Before we merge this into master we need to document the feature in README.md so all our users will be aware of it.

[codecov]

Codecov Report

Merging #957 (44c13c7) into master (17c1766) will increase coverage by 1.20%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master     #957      +/-   ##
==========================================
+ Coverage   84.83%   86.04%   +1.20%     
==========================================
  Files           8        8              
  Lines        1649     1835     +186     
==========================================
+ Hits         1399     1579     +180     
- Misses        145      150       +5     
- Partials      105      106       +1     

Impacted Files	Coverage Δ
operation.go	88.73% <100.00%> (+1.07%)	⬆️
parser.go	83.31% <100.00%> (+1.30%)	⬆️
types.go	100.00% <0.00%> (ø)
swagger.go	100.00% <0.00%> (ø)
schema.go	98.88% <0.00%> (+0.17%)	⬆️
gen/gen.go	95.52% <0.00%> (+0.24%)	⬆️
packages.go	73.33% <0.00%> (+2.85%)	⬆️
debug.go	50.00% <0.00%> (+30.00%)	⬆️

---

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 17c1766...44c13c7. Read the comment docs.

[pc-coder]

Before we merge this into master we need to document the feature in README.md so all our users will be aware of it.

Have updated the readme with an example.

[ubogdan]

LGTM

[ubogdan]

Thanks for your contribution!