diff --git a/README.md b/README.md
index 750c04478f0be6456e81d85b49401f4677550868..28ad5941ffb2c2ea4171d9d5f5c9cfb4a0220124 100644
--- a/README.md
+++ b/README.md
@@ -46,18 +46,25 @@ lat.get_tw(file_name_lat_new)
 #    if lat.lst[i].typ=='STEERER'      : lat.lst[i].Bx =0.0; lat.lst[i].By =0.0
 ```
 
-lib_tw includes a function to convert loss/elem to loss/elem-length. An example:
+lib_tw includes a function to convert loss/elem to loss/elem-length. Examples:
 
 ```
-# An example to make a bar plot with an output file of this script can be found in
-# https://gitlab01.esss.lu.se/ess-bp/pgfplots-examples/tree/master/loss.den
+# Note:
+# - For a density file, be careful with the number of runs.
+# - The instances for losses are "loss_pow", "loss_num", "loss_pow_ave", and etc for DENSITY class.
+# - For PARTRAN class, loss_elem2den function is already implemented as a method. 
+# - If file_name_dt isn't given, the half-cell lengths are used instead of drift-tube lnegths.
+# - dlt_dt is a small number used to identify DTL_CEL elements. (Play with this number is there is an error message.)
+#
+# - An example to make a bar plot with an output file of this script can be found in
+#   https://gitlab01.esss.lu.se/ess-bp/pgfplots-examples/tree/master/loss.den
 
 from ess import lib_tw
 
 file_name_den ='density_file_name'
 file_name_ptrn='partran_out_file_name'
 
-file_name_dt  ='len.dt_dtl.v85.txt'  # File with (half cell length) vs (drift tube length)
+file_name_dt  ='len.dt_dtl.v85.txt'  # File with (half cell length) vs (drift tube length) for DTL cells
 
 #-- An example for a density file
 
@@ -68,21 +75,12 @@ loss_from_den=den.loss_pow         # For a file w/ single run
 
 loss_den_from_den=loss_elem2den(s_from_den,loss_from_den,file_name_dt,dtl_dt=5e-6)
 
-# Note:
-# - Be careful with the number of runs.
-# - The instances for losses are "loss_pow", "loss_num", "loss_pow_ave", and etc for DENSITY class.
-# - If file_name_dt isn't given, the half-cell lengths are used in stead of drift-tube lnegths.
-# - dlt_dt is a small number used to identify DTL_CEL elements.
-
 #-- An example for a partran out file
 
 ptrn=PARTRAN(file_name_ptrn)
 
 loss_den_from_ptrn=ptrn.loss_den(file_name_dt,dtl_dt=5e-6)
 
-# Note:
-# - For PARTRAN class, loss_elem2den function is already implemented as a method. 
-
 ```
 
 ### Library