Question: I want to write a `regex` for extracting numbers from the following text (that is part of a bigger text):

```
 switchport trunk allowed vlan 206,220,23,234,250,262,21,283,2086,296,305,323
 switchport trunk allowed vlan add 334,340,342,365,380,404,41,414,42,421,434
 switchport trunk allowed vlan add 461,472,499,509,29,535,544,551,552,55,595
 switchport trunk allowed vlan add 642,672,690,697,701,704,711,800,2018,2020
 switchport trunk allowed vlan add 2054
 switchport mode trunk

```

I want to extract all the vlan numbers between **switchport trunk allowed vlan** and **switchport mode trunk**

I think that the pattern should be like:

```
switchport trunk allowed vlan (\S*) ((\d+),*)+(?:.|\n)

```

but don't know how to extract the other numbers (only the first one matched)

I use the pattern in `PHP` in `preg_match` function.

Answer: 
The reason why it's deprecated is that previous Swagger versions (1.x) used the `@Api` description annotation to group operations.

In the Swagger 2.0 specification, the notion of `tags` was created and made a more flexible grouping mechanism. To be API compliant, the `description` field was retained so upgrades would be easy, but the correct way to add a description is though the `tags` attribute, which should reference a `@Tag` annotation. The `@Tag` allows you to provide a description and also external links, etc.
An old question but may help using swagger 3

```
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    // Swagger configuration
    @Bean
    public Docket api() {

        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo( this.apiInfo())
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("API Reference").version("1.0.0")
                .description("something")
                .license("Apache 2.0")
                .build();
    }

    public void addResouceHandler(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
}

```