diff --git a/core/commands/swarm.go b/core/commands/swarm.go
index e42afc773..a2cecb00e 100644
--- a/core/commands/swarm.go
+++ b/core/commands/swarm.go
@@ -29,11 +29,11 @@ var SwarmCmd = &cmds.Command{
 	Helptext: cmds.HelpText{
 		Tagline: "Swarm inspection tool.",
 		Synopsis: `
-ipfs swarm peers                - List peers with open connections
-ipfs swarm addrs                - List known addresses. Useful to debug.
+ipfs swarm addrs                - List known addresses. Useful for debugging.
 ipfs swarm connect <address>    - Open connection to a given address
 ipfs swarm disconnect <address> - Close connection to a given address
 ipfs swarm filters              - Manipulate filters addresses
+ipfs swarm peers                - List peers with open connections
 `,
 		ShortDescription: `
 'ipfs swarm' is a tool to manipulate the network swarm. The swarm is the
@@ -42,11 +42,11 @@ ipfs peers in the internet.
 `,
 	},
 	Subcommands: map[string]*cmds.Command{
-		"peers":      swarmPeersCmd,
 		"addrs":      swarmAddrsCmd,
 		"connect":    swarmConnectCmd,
 		"disconnect": swarmDisconnectCmd,
 		"filters":    swarmFiltersCmd,
+		"peers":      swarmPeersCmd,
 	},
 }
 
@@ -90,7 +90,7 @@ var swarmPeersCmd = &cmds.Command{
 
 var swarmAddrsCmd = &cmds.Command{
 	Helptext: cmds.HelpText{
-		Tagline: "List known addresses. Useful to debug.",
+		Tagline: "List known addresses. Useful for debugging.",
 		ShortDescription: `
 'ipfs swarm addrs' lists all addresses this node is aware of.
 `,