Skip to contentSkip to conversation

Drivers: Xen: xlate_mmu.c: Fixed comment layout

PATCH In review Mark Railton 2 participants 13 messages Jul 23, 2018 Xen hypervisor interface

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Drivers: Xen: xlate_mmu.c: Fixed comment layout

Fixed issue with multi line comment

---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +3 -2
index 23f1387b3ef7..3b03bc1641ed 100644
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
2.17.1
#1 lore raw
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 6 lines
~Randy

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel
#2 lore raw
In reply to Mark Railton
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy
#3 lore raw
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

Thanks,

Mark

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel

#4 lore raw
In reply to Randy Dunlap
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

Thanks,

Mark

#5 lore raw
Quoted 47 lines · Mark Railton
Quoted 46 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Quoted 7 lines
Quoted 2 lines
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 6 lines
~Randy

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel
#6 lore raw
In reply to Mark Railton
Quoted 47 lines · Mark Railton
Quoted 46 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Quoted 7 lines
Quoted 2 lines
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 1 line
~Randy
#7 lore raw
Quoted 53 lines · Randy Dunlap
Quoted 52 lines · Mark Railton
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

Quoted 11 lines
Quoted 2 lines

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 1 line
~Randy

From 57c8104d2a30020005be16df2ca69ed66f6c4ae9 Mon Sep 17 00:00:00 2001
From: Mark Railton <[email protected]>
Date: Mon, 23 Jul 2018 22:28:53 +0100
Subject: [PATCH] Drivers: Xen: xlate_mmu.c: Fixed comment layout

Fixed issue with multi line comment

---
 drivers/xen/xlate_mmu.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +4 -2
index 23f1387b3ef7..2b77c79f8ce7 100644
@@ -151,8 +151,10 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/*
+	 * Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;

--
2.17.1

Acked-by
#8 lore raw
Quoted 96 lines · Mark Railton
Quoted 53 lines · Randy Dunlap
Quoted 52 lines · Mark Railton
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

Quoted 11 lines
Quoted 2 lines

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 1 line
~Randy

From 57c8104d2a30020005be16df2ca69ed66f6c4ae9 Mon Sep 17 00:00:00 2001
From: Mark Railton <[email protected]>
Date: Mon, 23 Jul 2018 22:28:53 +0100
Subject: [PATCH] Drivers: Xen: xlate_mmu.c: Fixed comment layout

Fixed issue with multi line comment

---
 drivers/xen/xlate_mmu.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +4 -3
index 23f1387b3ef7..2b77c79f8ce7 100644
@@ -151,8 +151,10 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/*
+	 * Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
--
Quoted 1 line

2.17.1

Hi,

a. The subject and the patch description should be in present tense, i.e., Fix instead of Fixed.

b. Ideally you start a new email thread for new versions of a patch (but Cc:
the interested parties).

For the patch itself:

Thanks.

Signature · 6 lines
~Randy

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel
Acked-by
#9 lore raw
In reply to Mark Railton
Quoted 96 lines · Mark Railton
Quoted 53 lines · Randy Dunlap
Quoted 52 lines · Mark Railton
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

Quoted 11 lines
Quoted 2 lines

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 1 line
~Randy

From 57c8104d2a30020005be16df2ca69ed66f6c4ae9 Mon Sep 17 00:00:00 2001
From: Mark Railton <[email protected]>
Date: Mon, 23 Jul 2018 22:28:53 +0100
Subject: [PATCH] Drivers: Xen: xlate_mmu.c: Fixed comment layout

Fixed issue with multi line comment

---
 drivers/xen/xlate_mmu.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +4 -3
index 23f1387b3ef7..2b77c79f8ce7 100644
@@ -151,8 +151,10 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/*
+	 * Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
--
Quoted 1 line

2.17.1

Hi,

a. The subject and the patch description should be in present tense, i.e., Fix instead of Fixed.

b. Ideally you start a new email thread for new versions of a patch (but Cc:
the interested parties).

For the patch itself:

Thanks.

Signature · 1 line
~Randy
#10 lore raw
Quoted 105 lines · Randy Dunlap
Quoted 96 lines · Mark Railton
Quoted 53 lines · Randy Dunlap
Quoted 52 lines · Mark Railton
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

Quoted 11 lines
Quoted 2 lines

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 1 line
~Randy

From 57c8104d2a30020005be16df2ca69ed66f6c4ae9 Mon Sep 17 00:00:00 2001
From: Mark Railton <[email protected]>
Date: Mon, 23 Jul 2018 22:28:53 +0100
Subject: [PATCH] Drivers: Xen: xlate_mmu.c: Fixed comment layout

Fixed issue with multi line comment

---
 drivers/xen/xlate_mmu.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +4 -3
index 23f1387b3ef7..2b77c79f8ce7 100644
@@ -151,8 +151,10 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/*
+	 * Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
--
Quoted 1 line

2.17.1

Hi,

a. The subject and the patch description should be in present tense, i.e., Fix instead of Fixed.

Quoted 10 lines

b. Ideally you start a new email thread for new versions of a patch (but Cc:
the interested parties).

For the patch itself:

Thanks.

Signature · 1 line
~Randy

Thank you for the feedback, I will make sure to take that on board.

Mark

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel

#11 lore raw
In reply to Randy Dunlap
Quoted 105 lines · Randy Dunlap
Quoted 96 lines · Mark Railton
Quoted 53 lines · Randy Dunlap
Quoted 52 lines · Mark Railton
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

Quoted 11 lines
Quoted 2 lines

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 1 line
~Randy

From 57c8104d2a30020005be16df2ca69ed66f6c4ae9 Mon Sep 17 00:00:00 2001
From: Mark Railton <[email protected]>
Date: Mon, 23 Jul 2018 22:28:53 +0100
Subject: [PATCH] Drivers: Xen: xlate_mmu.c: Fixed comment layout

Fixed issue with multi line comment

---
 drivers/xen/xlate_mmu.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +4 -3
index 23f1387b3ef7..2b77c79f8ce7 100644
@@ -151,8 +151,10 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/*
+	 * Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
--
Quoted 1 line

2.17.1

Hi,

a. The subject and the patch description should be in present tense, i.e., Fix instead of Fixed.

Quoted 10 lines

b. Ideally you start a new email thread for new versions of a patch (but Cc:
the interested parties).

For the patch itself:

Thanks.

Signature · 1 line
~Randy

Thank you for the feedback, I will make sure to take that on board.

Mark

#12 lore raw
In reply to Randy Dunlap
Quoted 53 lines · Randy Dunlap
Quoted 52 lines · Mark Railton
Quoted 37 lines · Randy Dunlap
Quoted 1 line · Mark Railton

Fixed issue with multi line comment

Fix [not Fixed]

Quoted 11 lines
---
 drivers/xen/xlate_mmu.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +0 -0
index 23f1387b3ef7..3b03bc1641ed 100644

drivers/xen/xlate_mmu.c int xen_xlate_remap_gfn_array(struct vm_area_struct *vma, · line 156

Quoted 8 lines
drivers/xen/xlate_mmu.c +3 -2
@@ -151,8 +151,9 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/* Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */

That is still not the preferred kernel multi-line comment style. Documentation/process/coding-style.rst says:

/*
* This is the preferred style for multi-line
* comments in the Linux kernel source code.
* Please use it consistently.
*
* Description: A column of asterisks on the left side,
* with beginning and ending almost-blank lines. */

Quoted 11 lines

although Networking code has a slightly different preferred style (as in your patch).

Quoted 4 lines
drivers/xen/xlate_mmu.c +0 -0
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;
Signature · 1 line
~Randy

Thank's for the feedback, I'll get that updated now.

Quoted 11 lines
Quoted 2 lines

I'm still kinda new to this, I assume I need to send the new patch via git send-email?

That is one option. Use whatever works for you.

There are several email clients that also work well. See Documentation/process/email-clients.rst.

Signature · 1 line
~Randy

From 57c8104d2a30020005be16df2ca69ed66f6c4ae9 Mon Sep 17 00:00:00 2001
From: Mark Railton <[email protected]>
Date: Mon, 23 Jul 2018 22:28:53 +0100
Subject: [PATCH] Drivers: Xen: xlate_mmu.c: Fixed comment layout

Fixed issue with multi line comment

---
 drivers/xen/xlate_mmu.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/xen/xlate_mmu.c +4 -2
index 23f1387b3ef7..2b77c79f8ce7 100644
@@ -151,8 +151,10 @@ int xen_xlate_remap_gfn_array(struct vm_area_struct *vma,
 	struct remap_data data;
 	unsigned long range = DIV_ROUND_UP(nr, XEN_PFN_PER_PAGE) << PAGE_SHIFT;
 
-	/* Kept here for the purpose of making sure code doesn't break
-	   x86 PVOPS */
+	/*
+	 * Kept here for the purpose of making sure code doesn't
+	 * break x86 PVOPS
+	 */
 	BUG_ON(!((vma->vm_flags & (VM_PFNMAP | VM_IO)) == (VM_PFNMAP | VM_IO)));
 
 	data.fgfn = gfn;

--
2.17.1

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel