Skip to content

Debian package description is too long #64105

@perlun

Description

@perlun

Is there an existing issue for this?

  • I have searched the existing issues

Describe the bug

If you type the following command on Debian Trixie: apt-cache search dotnet, you get the following output:

aspnetcore-targeting-pack-7.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
aspnetcore-runtime-7.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
aspnetcore-runtime-6.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
aspnetcore-targeting-pack-6.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
netstandard-targeting-pack-2.1 - NETStandard.Library.Ref 2.1.0
aspnetcore-targeting-pack-8.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
aspnetcore-runtime-8.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
dotnet-apphost-pack-7.0 - Microsoft.NETCore.App.Host 7.0.20
dotnet-hostfxr-7.0 - Microsoft .NET Host FX Resolver - 7.0.20
dotnet-runtime-deps-7.0 - dotnet-runtime-deps-debian 7.0.20
dotnet-runtime-7.0 - Microsoft.NETCore.App.Runtime 7.0.20
dotnet-targeting-pack-7.0 - Microsoft.NETCore.App.Ref 7.0.20
dotnet-sdk-7.0 - Microsoft .NET SDK 7.0.410
dotnet-hostfxr-6.0 - Microsoft .NET Host FX Resolver - 6.0.36
dotnet-runtime-deps-6.0 - dotnet-runtime-deps-debian 6.0.36
dotnet-runtime-6.0 - Microsoft.NETCore.App.Runtime 6.0.36
aspnetcore-targeting-pack-9.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
dotnet-apphost-pack-6.0 - Microsoft.NETCore.App.Host 6.0.36
dotnet-targeting-pack-6.0 - Microsoft.NETCore.App.Ref 6.0.36
dotnet-sdk-6.0 - Microsoft .NET SDK 6.0.428
aspnetcore-runtime-9.0 - Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
dotnet-sdk-9.0 - Microsoft .NET SDK 9.0.306
dotnet-hostfxr-9.0 - Microsoft .NET Host FX Resolver - 9.0.10
dotnet-runtime-deps-9.0 - dotnet-runtime-deps-debian 9.0.10
dotnet-targeting-pack-9.0 - Microsoft.NETCore.App.Ref 9.0.10
dotnet-host - Microsoft .NET Host - 9.0.10
dotnet-runtime-9.0 - Microsoft.NETCore.App.Runtime 9.0.10
dotnet-apphost-pack-9.0 - Microsoft.NETCore.App.Host 9.0.10
dotnet-apphost-pack-8.0 - Microsoft.NETCore.App.Host 8.0.21
dotnet-sdk-8.0 - Microsoft .NET SDK 8.0.415
dotnet-hostfxr-8.0 - Microsoft .NET Host FX Resolver - 8.0.21
dotnet-runtime-8.0 - Microsoft.NETCore.App.Runtime 8.0.21
dotnet-targeting-pack-8.0 - Microsoft.NETCore.App.Ref 8.0.21
dotnet-runtime-deps-8.0 - dotnet-runtime-deps-debian 8.0.21
libgtk2.0-cil - CLI binding for the GTK+ toolkit 2.12
libgtk2.0-cil-dev - CLI binding for the GTK+ toolkit 2.12

As can be seen, all other .NET packages have reasonably short "first lines" of the package description, except for the ASP.NET Core packages which unfortunately look a bit clumsy in this list.

To be specific, I think the problem is this. The other packages have a short first line, and then the subsequent lines describe the package/project in more detail, like this:

❯ apt-cache show dotnet-apphost-pack-9.0=9.0.10-1
Package: dotnet-apphost-pack-9.0
Version: 9.0.10-1
Architecture: amd64
Section: libs
Priority: standard
Installed-Size: 11910
Maintainer: .NET Team <[email protected]>
Description: Microsoft.NETCore.App.Host 9.0.10
 .NET is a development platform that you can use to build command-line applications, microservices and modern websites. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/core). We happily accept issues and PRs.
Description-md5: a622dd7930ee964c28183e89c2bf1c6b
Homepage: https://github.com/dotnet/core
SHA256: 552e7b4316440a41b096b7c54b9664e2436a61687c1cddc56c92e9cb98e969da
Size: 3764890
Filename: pool/main/d/dotnet-apphost-pack-9.0/dotnet-apphost-pack-9.0_9.0.10-1_amd64.deb

When we wrote the package description for the ASP.NET Core packages, we seem to have missed this aspect of how the debian/control file works, particularly the "single line synopsis" described here in the Debian Policy Manual: https://www.debian.org/doc/debian-policy/ch-controlfields.html#description.

❯ apt-cache show aspnetcore-targeting-pack-9.0=9.0.10-1
Package: aspnetcore-targeting-pack-9.0
Version: 9.0.10-1
Architecture: amd64
Section: devel
Priority: standard
Installed-Size: 16559
Maintainer: Microsoft <[email protected]>
Description: Shared Framework for hosting of Microsoft ASP.NET Core applications. It is open source, cross-platform and is supported by Microsoft. We hope you enjoy using it! If you do, please consider joining the active community of developers that are contributing to the project on GitHub (https://github.com/dotnet/aspnetcore). We happily accept issues and PRs.
Description-md5: 88353a21ef036bbcf28580517f14867a
Homepage: https://asp.net
Depends: dotnet-targeting-pack-9.0 (>= 9.0.10)
SHA256: 22674dc7b586adfc1f3a1abb73896f9255b4b0bf6f747162eb8482776eaf090b
Size: 2015586
Filename: pool/main/a/aspnetcore-targeting-pack-9.0/aspnetcore-targeting-pack-9.0_9.0.10-1_amd64.deb

Expected Behavior

No response

Steps To Reproduce

No response

Exceptions (if any)

No response

.NET Version

No response

Anything else?

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-area-labelUsed by the dotnet-issue-labeler to label those issues which couldn't be triaged automatically

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions